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GETTING 

STARTED 


Copyright 2003 hy Dave Mark 


Getting Started: 

Project Builder Revealed 


In this iiionrh’s column, we’re goin^ lo explore some of 
Trojcct Biulder’s ncx)ks and crannies. The column started on a 
completely different tack, when I found myself trying to find tile 
definition for a specific class fiinction. 1 dug through the 
/Deveioper/Documeniulion/ directory, which is absolutely 
worth doing, but there’s a lot of doc there. 

1 went on line to ask some of my Projea Builder buddies 
how ihey would go aboiii solving this panicukir problem and 
got a fjuncb of diffcTeni responses, all of wliich led to the same 
end, and each of whicli Uiught me something new about Pioject 
Builder, lliis month, I'd like to share wbai I've learned with yon. 

CHJiATllSG CRANNYTeSTER 

[jet’s start off by creating a new project, called Crannylester. 
Uiunch Project Builder, select New Projecl.,. from die File menu, 
scroll down 10 the bottom of the New Project window and create 
a i'oundation 'fool project. Name the project CrannyTester. 

One Window, Some, or Many? 

One Project Builder feature I really like is the aliility to 
customize PB's use of windows* Select PreftTences.*. frcmi the 
Project Builder menu, then click on the Task Temjdates icon at 
the top of the prefs window. Now click on the Basic Settings 

tab (Figure I)* 


e 

J>iroJ«Cl ejjfWflr F'rtr«Ftfvci'E 
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'll ^ 
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f laiic Seltingf f Ckpah Cgoflgurmlan ][ ManAge Ttinplatci 1 



Wfiiddw Santt Windows Mdn.y Windows Custom Strings 


TH& clwKci aftove dnewlne how Project lubidcr when TwmD^ace wlntfowi. 

“Slnflle Wlffidow'' Ml uth.1 w e iJihjie Ml-w-wie wf4i(lsw. 

3onvt Window" DpOni HDatoiv wuitlvwt l0» the Hud. hiUcl. jnd DebAi^ W^^v, 
'U^nfi Windthwi" opcrti 1 lepurAie wLfldow (Of ckveloiptnbnt uilL 
'CuiC-qm llEninQ'E.' Afeltiraic IhoU wofi iPl m tho LkpctI ConfIgurdlKin mb. 


Figure L Wv tviudow temphie scitings in 
the Preferences.,, dialog. 

As you can see, there are four basic wandow setups. Single 
Window forces the entire Projeet Builder interface into a single 
.swiss-army-knife of an interlace, a single window filled with 
tabbed panes (Figure 2). If you are working on a laptop or on 
a smaller monitor, this is a very efficient way to go. 


Dave Mark is a long-time Mac developer and author and has written a numlxT of Ixx^ks on Maciniosh development, inchitling f.eam C on the 
Macintosh, Learn (7++ on the Macintosh, and The Macintosh Programming Ihimer series* Be sure to check out Dave’s wch site ai 
http://www,spiderworks.com. 
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Figure 2. Ihe CrannyTesterproject in Single Window mode. 

One hil of funkines^s t{> t)e aware of: When you diange 
selections in the Task Templates preference panes, your 
changes won't take effect until you open a new window . 

To get the change to affea your current project, make the 
change, then close your project and reopen it* 

'lb see this for yourself, set the preference to Single 
Window, then open a project or create a new one. A .set fif 
honzonuil tabs (siiiiiiar to tlic Find/BLiild/Run/'Del>ug/CVf) 
tags in Figure 2) will appeiir in tire window'. 

Now go into preferences and change to Some Windows. 
Even if you dick the Apply fmuon, Lite lal>s will still lx; 
visible. Now' dose ilte project and reopen it. The tabs 
disappear as the Some Windows preference is applied, 
Cliancc's are, you'll pick a itkxIc you like, then crexite all 
your projeas in tliat mode. If you do find yourself playing 
with the windowing modes, \ye sure to reopen the project 
to .see itic effect properly, 

“Some Windows" adds separate windows for Find, Build 
and Debug. “Many Windows” opens everything in its own 
window^ and feels most like CodeWarrior to me, I Sfjend inosi of 
my time in Some Windows but love the flexibility of switdung 
to Single Window when Tm on the mad. Sweet! 

Finding the Doc 

Now that you’ve gol your project .seaip the way you like it, 
I'd like to share anoUier Project Builder ncx)k with you. Or 
maylx? it’s a cranny, llnimm. 

Open the CrannyTester project you created at the beginning 
of tliLs month’s column. Click on the Files lab, open llie Source 
triangle, and click on the source file mainaii. Here's the source 
C(xle you should see: 

#ltnport <Foundatioti/i'Qimdation > ti> 

int main (int argc, const char * atrgvll) { 

NSAutoreleasePool *pool“[fNSAutQreleaaePool alloc) inlt]; 



Fetch 


Walk the dog. 



Fetchsoftworks.com 


Version 4.0.3 now available. 
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// ctxJtf here... 

NSLogC@''Hallo. World i" 
[pool releaso]; 
return 0: 

I 


]; 


on the triangle to die left of NSArray, revealing NSMu table Array* 
Click on the lxx>k icon for NSMutableArniy* The doc: for 
NSMiiiableAiray will appear in the main pane (see Figure 4). 


Tliis is llic default .source for a Foundation Tool and should 
look reasonably familiar to yoir One of the keys to understanding 
any new framework is the ability to find desc:riptions of the classes 
and utility functions that you encounter in the framewt^rk'.s 
documentation. One thing Apple's dev tcxils have no .shortage of Is 
documentation. While 1 do recommend that you spend some time 
prowling tlm)Ligh the /DevcIoixT/rkxmmenlation/ .sulxlirectories, 
iliere are some clever little slioncuts built into Project Builder that 
will bring you right to the pages you are looking for* 

Let’s start with the inosi obvious padi. If you click on the 
Clas.ses mb, youll *see a list of classes in the upper pane, with a 
list (empty, right now) of memt^ers in the low^er pane. Below 
that is a popup menu that should be set to "Heirarchy, al! 
cla^sses" with an Options button to its riglu (See Figure 3 ) 


% 


HlerjfdiV. 4II Tl flDptions"^ 

Figure 3 . Classes kill with its list of classes. 

Lets say you wanted to read up on the NSObject class (and 
you .should ). NSObject is the root of most of tlie classes you’ll 
use to develop your Cocc>a applications. Click on NSOhjeci in 
the Class pane. You 11 immcxlialcly see a list of its memlKT 
functions in tile low'er pane. Click on a memlier function, and 
that ftmetion’s declaration appears in the main editing pane. 

Now for the t (K)lness. Notice tliat liltle blue book icon to 
the left of the NSOi:>iect entiy in the Class pane? Click on it. Ka- 
cliingi 1lie NS(3bject documentation appears in the editing pane. 
Apple s docu mentation is extensive, For each class, you1l learn 
wliere the class fits into the class hierarchy, protocols it 
confomis to, in what inckide files it is declared, meth<xls and 
fields (with lots of ^'see also" links), and more. At the very least, 
spend some Lime reading about the NSObject class, since the 
vast majority of your classes will inJierit from this class. 

Here’s another example: Go back to the Chss pane and click 
on ihc triangle to ihe left of NSObject. Tliis will reveal ilie clas.ses 
derived from NSObject. Neiir the top of tliat list is NSArray. Click 
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figure 4. We documemaiion forNSMmableArmy. 


Notice that the doc lists the inheritance hierarchy NSArray : 
NSObject. As you can see, youVe got several ways to find your 
class in the hierarchy. You can use tiie triangles to drill down 
through a parent class* You can also use tlie '"Inlierits from” links 
in the doc to gel to an ancestor class. 

Nt)w take a look at tlie [xjpup menu at the l30ttom of the 
Members pane. It cmrently reads "Hierarchy, all classes’*. There 
are some otlter choices as well. Selecting "Hierarchy, project 
classes" will restrict the class list to classes youVe deelared in 
your project. 'Thit, all classes" gives you a straight alphabetical 
listing of all classes, in esjxxiive of hierarchy* *fhis is very useful 
when you knew the name of a clasps, but dcm1 know where it 
siLs in die class tree. “Flat, project classes" dex^s the same thing, 
but restricts the list to clas.ses used by your jiroject. 

Anodier nice PrrijecT Builder feature is that you on add your 
own customized views to this list. Figure 5 shows tlie dialog that 
ai:>|xars when you dick the Ofitions l:^utton to the right of the popup 
menu. Basically, you use the controls in the dialog to cusiomize the 
class listing, then dick the Add... button. When prompted, name 
your custoni listing, and it will ai>|>ear in the ixijiup menu along 
witli the other listings. S|iend a few minutes playing with this dialog, 
just so you have a sensc^ of wliai ofiLions are avuilalile to you. 
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Figure 5* This dialog appears when you click the 
Optiom button in the cjlasses tab, 
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Other Paths to the Documentation 

As ytjy expect, tliere are (Hlier ways to from a 

syiTilxjI TO iis documentation. In your CrannyTesier project, click 
on the Files tab, then open the Source triangle and click on 
main.m. Now hold down the option key and double-click on the 
class name NSAutoreleasePooL 

"ra-daa! Project Builder takes you straight to tlie doc page 
for NSAutoreleiLsePool , To get back to your .source code, click 
on the “back’* button (Lite huUon the cursor is pointing to in 
Figure 6). Go ahead, click on it. Just like your browser, it takes 
you back to the previou.s page, in this case, your stxirce code. 


® CrannyTester 


T1 


B 


X o 


NSAutoreieas^Pooi (Oiajective *Q v . <h 


Go 

NSAutoreleasePool 


frum: 

.NN01zjks.-[ 

Cfiiifoiiiia to: 

N SOhsTi f JNSO)Tji:ill 

Di'tiiiri'tl in: 

l-i s i) I idiiJk 'N S A u I() rcLit>cI ‘iwit Jj 


figure 6. ’Ihe curs(jr is painiing la the hack button. 


Let's iij another experimenl. This time, hold down the 
coniinand key and double-click on NSAutoreleasePooL Instead 
of jumping to the doc, Projea Builder jumps to the declaration 
of NSAuiorclcasclk)oi in NSAuicJreleasePoolh. 

Notice the two popup menus to tlie right of the back and 
forward browser buttons, llie first popup (Figure 7) lists the 
recently visited frames, including source code and 
documentation. The second jK)pLtp (Figure 8) allows you tcj 
jump to individual declarations within the ciinenl source file. 


® CrannyTest 


X o 
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#iHpi 

^tnti 

void 

voxet 

vo\d 


Fi>urtdaiionTOC.html 
||i]^ main.m 
[ti] NSArray.tj 
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ii 

(Objec?ive-C)i 

NiSMtiCAbicArray (objective-Cl 
[hj MSObject h 


^ MSOi>jea,html 

#_toKeo I 
•.reservedS; 
•_reserved2 1 


figure 7 'Itie/irsl popup to the right of the hwwser huttom 
sboufs recently visited files. 


» CfAnnyTester - NSAuioreleasePooLh 


[B 


N5Au toreleasePooI. fi 7 C ^ aye ^^5Au tore JessePoo I 

SAutorelWei^i .h 

c^yright 1994-2002, -addObject: 




Fouodptlon/USOfaject ,h> 

e NSAutoreleasePool : waDbject { 

*_tckjsr\; 

*_re^rved3; 

*,reserved2; 

♦^reserved; 

Figure fL 7he .second J)opup lets you Jump to the deciaratiom 
wilbin the current flie. 


Tull Nfixr Momh,.. 

Ihere are a lot mom elanents worth exploring within Project 
Builder hut, unfortunately^ Tve run out of rcxim. More cool stulT next 
montli, plus well dig into some actual code. See you then. © 
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SECTION 7 


By Rich Morin 

Tk:A Portable GUI Toolkit 


expressiveness and simplicity count for 
a lot 

Last momhj T mentioned Tk, referring to it u,s an XU Icxdkit. 
This month, ILI like to eover Tk in a bit more detail. I should 
Ix’giti, however, by clarifying that Ik is not just an XU toolkit; 
in fact, it is a platform- and language-independent Gin toolkit. 

Tk c:an be used with C, Perk Python, Eli by, Td (Tk's original 
counteniart), and many other programming languages. It can be 
used with Aqua, PalmOS, XU, ^i^^d assorted Microsoft APIs. In 
sumniaiyj any mcxlern computer with the appropriate hardware 
probai>ly lias Tk support. 

Tk also wins big on expres.siveness and simplicity. Most G1 il 
toolkits (e,g., Cocoa and a.ss<.)rted XI1 “widget seLs^) are complex 
and have stcet) learning curves. Tk, in contrast, is remarkably 
simple to program, once a few basic concepts have been 
mastered. Although iT may not have all the features of Cocoa, 
it supports most of tlie widgets you are likely to need; it also has 
ways to add new widgets, if youTe feeling sufficiently motivated, 

Tcl/Tk 

Because Tk started as a toolkit for the 'I'd language, most of 
the Tk resources you 11 find are actually for Td/Tk, the 
language/loolkil comfhnation. Also, because Td/Tk is the focus 
of development, lite other language l^indings (e.g., Perl/'^^, 
Tkinter) occasionally lag behind. Finally, if you want to extend 
Tk, you1l probably find yourself coding some Td in the process. 

In slum, you should plan to learn a bit of 'I’d, even if you 
intend to use Tk with some other language. Fominately, this isn't 
particularly painful; Td .syniax only lakes about five minutes to 
learn (most of which you'll spend accepting the idea of how 
simple the syntax retilly is 

Pick up a copy of the Mac OS X Td/Tk port from: 

hrtp://wvvw.apple.com/downloads/macosx/unix_open_source/tcltk.html 

Be sure to look at the EeadMe files; tljey contain a number 
of useful pointers and critical details. After the (dmg, mpkg) 
installation finishes, you should find a copy of ''Wish ShelT: 


/Applications/Utilities/Wish Shell.app 

When you start up the app, two windows will appear. The 
Console" window allows you to run I’d comniands, viewing 
the oiitpuu 

set a Ul 
123 

(3 2 X set b [expr $a ' 2] 

246 

C3 3 % 

Td isn't a conventional language and it isn't processed in a 
conventional manner. Alrhfmgli .some paits of Td synUix look a 
hit like C or l^crl, tlie interiireler is simply iierfoiming a sequence 
tjf commands and string substitutions. 'I hus, the first line sets a 
variable (“a'') to the text string You may think of this as 

a numeric value, but [he Td interpreter doesn’t 

The second line does tliree things. First, it performs a 
variable substitution", replacing "$a” with the value "‘123". Next, 
it performs a ‘*comiriand substituticjii", replacing the expression 
'‘[expr $a * 2]" with the result (246). Finally, it sets “b" to the 
resulting value. 

Now,, let's liring Tk and the other (Wish Shell) window 
into play: 

() 3 % button .b -text "Hello, vorld!" comraand exit 

(3 4 % pack .b 
() 3 % 

tf all weni as expected, the "Wisli SlicIF window should 
now contain a button labeled “Hello, wtjrld!”. Pushing ihiii 
button should cause the Wi,sh Shell to exit (and lK)ih of its 
windows to disappear). In two fines of code, you have createrl 
and run a (tiny) windowing applicatinnl 

If you simply want to program in Td/l'k, you are now in a 
p<;sjtion to do so, I'he results will look nicely Acjuafied (Aquatic?) 
and you d(;n’t have to tell anyone how little code you wrote! If 
you bec'ome intrigued with 1’cl/'l'k, Ix? sure to pick up John 
Ousterhout's excellent (If dated) Td and the Tk Toolkit” 


Rich Morin ha.s been using computers since 1970 , Linix since 1983 , and Mac^hased Unix .since 1986 (when he helped Apple create A/UX 1 . 0 ). When 
he isiTt writing this column ^ Rich urns Pnme Time Fieeware (www.ptfxom), a publisher of books and CD-KOMs for tiie Free and Open Source software 
community. Feel free to write to Rich at rdm@ptf,C 0 m, 
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(AcldtM>n-Wesley)► J(>hn created both Icl and Tk, so he's 
eminently qualified to say how they should l>e used. 

PERiyTK 

Although Tel is syniaciically inieresring, extremely portable^ 
and quite tlexilile, you imy prefer (as I do) it> dt> your atnual 
programming in some other language. PerL^k allows Perl 
programmers it) use Tk widgets, while keeping die rest of their 
code in Fed. As hinted alxjve, anak>gous libraries are availalile 
for C, lY^hon, Ruby, and other progranuning languages. 

flaving said this, \ should note that Ik calls may not be a 
smooth fit into the sytitax of die chosen language. Here is a 
Perl/I'k translation of our simple window example: 

use Tk: 
tiiy $iifuj; 

Snrv ^ new Main Window: 

$b - $iiiw yBuLCont text “> 'Heiio. world! * ♦ 

-ectwiiand sub I exit: )): 

Sb ->packO: 

Hainloopt): 


'Itiis code is substaniially larger, l>ui the original ll 
commantls and arguments are still present (albeit buried in 
Objeci-OrienietJ Perl .syntax Several lines of overhead ccxle 
bring in the I'k module, declare a couple of variables, create a 
window, and finally, start up the Tk event loop. Also note that 
wc arc no longer using the Tcl exit command; instead, we 
have created an anonymt>us Perl function which uses Perl’s own 
exit command. 

If you waitl to [)lay with Perl/Tk, your first step should lie 
to purchase a copy of “Learning Perl/Tk” (Nancy Walsh, 
O'Reilly). Huy Ousierhout's lxx>k, tcx>, if you can; you won't 
regret it! 

Now for the bad news: installing PedA*k on Mac OS X is 
c|uiLe complex and (worse) still in a state of flux. It Ls [)ossil)lc, 
with soinc difficulty, to make Perl/TTc work with Apple’s XI1 
serv^er and l>evelo[XT Kit, 1 don1 know of a way to get Perl/fk 
to work with the native I'k port (as installed above), but T hope 
to have more inlbrmation by the time this column is in print. 
Look for instructions on 

http://vvww.rfclxom/rdm/section7/perltk.html 

I also suggest, for the brave-hearted, die following links: 

https://ltsts*soyrceforge.net/lists/listinfortd-mac 

http://tc!.aaivestaiexom/ftp/mac 

http://td.sourceforge.neT (MacTcrnc, TcITkAqua) 

http://www.scfiptiGxom 

http://www.tcL tk/software/mac/AppleScripLhtml 

http://www.td.tk/software/mac/index.html 
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MAC OS X 

PROGRAMMING 

SECRETS 


By Scotl Knaster 


1 am honored, privileged, and more than a little thrilled to 
welcome Scott Knaster to die fold here at MacTech. In the 
Mac programming universe, Scott is a legend, lioth for his 
sense of humor and for hooks like Macintosh 
Prograinining Secrets and Ilow to Write Macintosh 
Software. While 1 was busy writing about C and die basics 
of the Mac Tcxilbox, Scott was taking folks to the next 
level, writing alxjut off screen drawing, spinning airsrirs, 
V13L tasks, dialog filters, etc. 

And that’s just what we’re gonna do here. While Getting 
Started wiQ focus on the basics, Mac OS X Programming 
Secrets will take you to the next level And for lliose of 
you who have yei to exfx'rience Scott, trust me. You are 
in for a treat! 

Dave Mark 
Kditordn-Chief 


'ITianks, Dave, for that awcst>nie intrcxliicdon. I'll try 
rniglitily to live up to those high expectations. And now, let's gel 
started. But how to begin? 

[Option 54*^1: ihe wacky iwo-linerj Well, I haven't written 
anydiing about Mac programming since aixHit 1990. So as I 
was saying... 

lOpdon ^2: the clueless.] Hi. IVe Ixcn basically out of the 
Mac universe for the last 10 years. Did anything interesting 
happen? Is Apple sdll in business? Excuse me... ihe company is 
am by OS is now hised on lebaP Haiialiahahahaha!!! 

You big kidded 

[Option ^3: keeping it real.l 

'that's me: always with the joking around. But really, when 
1 think about writing for MacTech, my whole MacLife (not the 
same as iLife) flashes Ixfore my eyes, and 1 ponder how I got 
started on the Mac, how 1 ended up back liere again, and what 
happened in between. 

Programming Is Great Fun 

My story, dear reader, is tme of extreme good fortune 
and a personality tic. The lucky part came back in 1984 when 
1 managed to find a job in the developer support department 
of the Macintosh division at Apple, I knew a little alxml 


pn^gramming and was in love with working at Apple, liut I 
had never seen anything like the Mac - of course, very few 
of us had. 

On my first day, my boss, Cary Clark, showed me the 
professional Mac development envirf>nmeni of the era. It 
consisted of a Mac with 128K RAM, a LL^ conneaed to the Mac 
for txtmpiling and building applications in Pascal, and an Apple 
III (or Apple ///, as we insisted on spelling it) u.scd as a dumb 
terminal for talking lo the objectHXxJc debugger. Yes, it took 
three-fourths of Apple’s computer models just to say “Helio 
World" on an undeqiowered original Mac, 1 was in awe. 

I spent the next 3 years helping develt>pLTS get their apps 
running on those early Macs. Because 1 was lucky enough to 
be in the right place at the right time, I learned a ton of cool 
stuff about Mac programming and debugging, like liow to 
figure out what was on die .stack, what really happened when 
heaps were compacted, and what caused system errors. 
Because lots of people were interested in learning these 
things, 1 wrote it all dciwn in a couple f>f lieioks, thus freeing 
my brain cells for imporlanl work, such as knowing it wa.s 
Handy Van Warmer wlio sang the smash hit Td Really Love To 
See You Tonight". 

Attentive readers will recall that way back a few paragraphs 
ago, I said it wa,s luc'k and a personality tic that helped my career. 
The luck was finding myself in Mac developer supfiort; the tie is 
that when 1 learn alx)iii ccxil new Let:hnol(}gy, like Mac 
programming, 1 just gotta lell other people about It. 1 can't stand 
keeping it to myself. I’his is a wonderful trait for a leeli .supfiort 
guy and a writer. 

Eventually, I got disimeled fiy a shiny object or sometliing, 
and 1 wandered away from die Mac for awhile. I wrote many 
charming but now^-useless lechnic'al doirs, first alx)ut Pink, one 
of Apple's several failed fix-the-Mac-OS caisades, Lind then 
aboiu Magic Cap, a really wonderful OS and UI toolkit for 
personal eommunicators that just didn't catcli on. Most 
surprising of all journeys, I ended u]> sjieiiding a number of 
happy years at Microsoft (yes, that Microsoft), at first working 
tm Mac software, then writing books alxnit Windtiws user 
interface guidelines, of all things. 

New Thlngs HiU>pENED 

And then, Mac OS X sprang forth. A hypnotically pretty 
user interface, a ibundalion based on Unix (go figure), and lots 


Scott Knaster has Ix'cn writing alx>ul Mats for as long a.s there have been Macs. Scott's lxK)k.s Houf To Write Afadnlosh Sf^i^tv and Macintosh 
Programming Seemts were required reading for Mac programmers for iiKsre than a decade. Scott wrote developer Ixxiks for General Magic and worked on 
Mac software for Micnisoft. St:olC.s bmks have been translated into Japanese and l'ast::il. Scon has every Issue of Mad magazine, which explains a lot. 
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of attention and cckjI new app-s ome with it. Apple's dark 
days had come to an end. AHhough I was making my living 
on itiai other platform^ 1 was always drawn hack ttj the Mac. 
When Apple started shipping Macs with OS X pre-instalied in 
2001, 1 lx>ught an iBook and liad a torrid affair with the new 
operating system. Although it wasni ready for prime time 
then, you could tell that it had a great future - kind of how it 
felt using a Mac in 198^ or so. For the next two years, I always 
found time to keep up w'itli OS X, rnes,sing around with 
development tools and generally having fun with ail iIjc new^ 
stuff Apple kept tossing our way. 

When 1 said hirew'ell to my employment at Microsoft (and 
my WinXP lifestyle) earlier this year, 1 fell down die OS X rabbit 
hole at fun velcx.iiy. 1 founrl myself getting up early and staying 
up late, playing with all the toy.s: Project Builder, Temiinal, 
CxK'oa, Carlx)n, etc. Mac programming todiy is a surreal fusion 
of traditional Apple stuff and full-on Unix, and wc haven’t even 
Ix^gun to tap ail the power dial's in ihere. My goal in WTiting this 
c’olumn is to stay one step ahead, to show you somedirng each 
mondt that you didn’i know about before. 

I find myself cursing Unixy things like folder peniiLSsions 
and command line syntax lx>olxx:)S, even while I enjoy trying to 
figure diem out. Placing Unix under Aqua is a litdc like having 
a hcxKl on my car Mtistly I just drive the car, but once in a w'hilc 
1 like to open the htxxi to learn aixrut or tweak something 
inside. Sometimes thtif's frustrating* but ids always eduoatirmal. 

Pm past the point where operating systems are a religitin 
with me, 1 lived happily on last rnillenniurn's Mac OS for a long 
lime, Windows for a few years, and tiow it's Mae OS X. There 
are things I like and dislike about each of them. I enjoy having 
all of them around, bec'ause they're fun to delve into and diey 
all help me get w^ork done, Althougli it's far from perfeta, OS X 
might l)c* my favorite OS ever Ixfcause there s just so much siujf 
to mess with. And Ix^cause after all diese years, I find that my 
brain is still tuned to Apple's lTequcnc 7 : I keep coming back to 
Apple products because they usually feel right to tiic. 

TiIEIU: Is PLLfNIY To Dt) 

So the truth is this column is my excuse to keep diving into 
08 X programming and tlien inflkaing the results iifHin you, dear 
reader, beaiuse I just can't keep it io myself, Tliere's so much to 
write about: great tools, cool tricks wirli frameworks, little- 
knowai APIs, dcl>ugging tips, odd and fiin nooks in the system. 
Everything is new' again, and we’re all Ixizos on this bus, 1 want 
to write alxiut all of it at once, liut unfortunately the laws of 
physics pmliibit this, so HI do it one column per issue. 

Speaking selfishly, 1 know Em going to have a great time, 
and I hope you find some of it useful or amusing. Ix;cau.se that 
would jjleasc the publisher and editors of MacTech. So iJianks 
for coming along. 

And 1 now that 1 think of it, it was England Dan & John 
Ford Coley wdio sang the smash hit Td Really Love To Sec You 
Tonight". 1 guess I I Hotter sian writing m<)re stuff dowm to free 
up brain space. 
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WIRELESS 

METWORKIMG 


By Neil Tickiin, Publisher 

Serious Wireless 


Looking to get Point-to-Point Wireless 
between locations? Here's a truly robust 
solution. 


Why Thf Change? 

Some of yoti may recall my first wireless adicle a few years 
back {MacTech Magazine, January 2000 issue, “Going Wireless!" 
<http://www-mactechxorn/articles/mactechA/oL 16/16.01 /GoingWireless/>). 
In iliat article, \ wanted to implement a relialile wireless link 
l:)etween my house, and ilie office. I S}>ecifically wanted to do 
anything and everything that I could to avoid tlte phone 
company for my net connection. Wireless gave me tiie ability to 
get high quality, reliable access that was completely within my 
control, and wiihoui any monihiy fees. Sounded gcx)d to me! 

And it ims great. For years, 1 reliably had a 1.^ ml>ps 
connection lx?tween my house and my office a drive of about 
25 miles, and about 15 miles as the bird flies. 1 was able to do 
it with off the shelf materials Lucent Ixixes (very similar 
technology to whafs in the original Airport Base Stations, hut 
witli Lucent software to glue it all together). 

The problem is, L4 mbps is not what it was 3+ years ago. 
More importantly, even though I wa.s physic-ally fairly close to 
the oftice, 1 was suffering latencies in the 3B-miltisecond range. 
Now while lhafs not a prtiblem for things like web browsing, 
certain functions like access to our FileMaker Server were way 
tCKi slow for me to tese the way I w'anted to. 

You see, some applications move a lot of very small pieces 
of data around. The theory we had with our FileMaker 
sluggi.shness is that the latency was tex) gre;il (especially 
compared to the LAN at the tilTice), and essentuitly, it was cruising 
the network to “thrash" wlten certain funaions performed. As 
we saw in installing the new setup, nedutMng latency made a huge 
difference in the w'ay these systems worked. 

Ify die way, in ca.se you were thinking aixmt utilizing the 
new 802.1 Ig standard at 54 mbps, beware of something. 
802.llg is great for indcK>r LANs, but the standard is still in flux, 
and more importantly, the amount of distance you can get (at 
least inside) is alx>iit 1/3 of wliat is available with 80251b. So 


far, fve not heard of anyone using 802.11b for outdoor point-tO“ 
point access- 

The New Pl^vn 

You may rememlx-T from llte previous article that 1 don't have 
line of sight from my house to the ofiRce. The solution? I kncx:ked 
t>n the door of a neighbor up on the hill and olTered him a great 
Internet connection in ext-hangc for having .some equipment on 
his roof, A.S you might well imagine, that’s a deal that works out 
well for alL So, unlike many installations. 1 acUially have a point 
to point-tt>point connection Ixawcen my house and the otfice. In 
other worcLs, my c:onncctian goes from my house to David’s 
itouse, to tile office |x>int to point to point. 

What 1 needed to do now is find new equipment that 
could reduce live latency, as well as increase the bandwidllt. 
I turned to my friends over at West I ink Wireless 

http://WWW,westlinkwireless.com. Hddie Wesi helped me to take a 
look at the problem and recommended that we look at some 
of the proprietary radios oul there. 

TJie Radios 

We .selected the Trango Broadband radios 

<http://www.trangobroadbandxom>. Specifically, the Accuss5800 
Wiiieless Broadband Acce.ss Solution. SpectOcally, we're using a 
combination of their “Access Points” (AP) and their “Subscriber 
Units" (SIJ). The APs are typically located at ihe c-enter of a 
network, or head-end of a w-ireless pcvini of presence, and they 
communicaie with one or more SUs. You ran have up to 500 SIJs 
pcT AI- uniL WeVe using the Acce.ss Point, M58(H)S-AP-60, 5895; 
and a 3 Mile Subscriber Unit, M5800S5U, $491 (There's also a 
10-jiiile Subscriber Unit, which has a DirecTV style dish on it.) 

Radios have a certain amount of range where the signal is 
“visible". In Trango's terms, their AP imils liave a 60-degree 
sector. Because my house and my office arc not within the same 
sector of visilvility (iliey arc on oppasite sides of David’s house), 
I need lo have to Access Pevints each talking to a ,Sul>.scril)er Unit 
(4 radios in all). Put another way, the AP at my house talks to a 
SIJ at David's which is connected through a small Ethernet switch 
to an AP at David’.s which talks to an SU at my office. 

The radios, and antennae are all ct^mbined into a single, 
weatherproof unit. No power is necessary on the roof, only 


Neil Ls the puhlishcr of MacTctli Magzcz.ine. As a closet geek, he lends to cxperimeni with some of the more interesting forms of tethntilogy, and then 
frightening die maga^iine staff hy announcing hell write alKnii them. You can reach him at publisher@maaech.CDm 
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at the power injector, which likely near your router or 
switch. The units use a “power injector" over Ethernet, The 
radio can be 100 meters from the power injector. Tlie 
injector has three connections — a power cable, and two 
Etlicmet |x>rts Cone to your LAN and one to the radio). For 
some installations, not having power at the radio is critical ... 
and it's almost always handy. 



figure L Access PoirU (the 3 Suhscrilxr (tnit) 



Figure 2, AniLmnafor 10 mile Subscriber Unit Configitrcttion 


Radio Tf.ch Stuff 

These Tningo radiexs are pretty cool. A .specific benefit to us 
is iJiat they are not Imsed on one of the 802.11 standards, and are 
therefore they were able to do stjme special ihin^. are high 
performance and secure. Spt‘dfically, they are based on Direti 
Se^ [lienee Spread SpectRim technology that operates in tlie ISM 5.7 

- 5.8 GHz range. Ibey theoreficTilly deliver up to 10 Ml^ps user 
throughput reliably. An Access Point can l?e up to 20 miles from 
the SIJ^ and sup|K)rLs QoS and have on the fly bandwidth 
tiiR)ttIing. Spread spectrum has the inherent advantage civer oLher 
forms of transmission in that it cun si ill rectjver data even in the 
most noisy of KF environments where other architectures fail This 
isn‘l sometliing new', just something very reiiable am! rt)busL. 

Using a proprietary protrx'ol called SMARTPoUing, the 
Trango mdios nre able to discover one another, as well deliver 
bandwidlii more efficiently. And, if you are conc:erned witJi 
balancing the signal l’>etween SUs at different distances, the APs 
have a “powder leveling" feature. As jxirt of the ’'powi'er on’’ 
.sei|Uence, die AP detcnnincs how far away a given SU is, and 
actively dimini.shes or increases it.s cniTpur power to ensure a 
quality of servit^e. 

To keep usage under control you can optimize the 
Cotniiiitted Infonnatiun R^ite / Maximum InfonnuLion Rate 
(CIRj^MlR) and provide baixiwidlh management/dirottlmg per 
individual SI I. 

One of the more interesting features is the Dynamic RF 
Packet Sizing allows the radios to ciptimize data bandwidth 
utilization with maximum RF sensitivity. Unlike other 
solutions which use fixed RF ]>acket sizes, the Access5800’s 
protocol dynamically analyzes each Ethernet packet and 
transmits at an optimal length, 64 bytes (in the case of URL 
requests) to 1600 ItyLcs. 

SU*s can Ix^ remotely managed through tlie AP using a host 
of co 2 nm;ind.s or via H'l'IV web interface, telnet, or serial 
interface. Tlie radios have a built in RSSI LED and RSvSI 'I'elnet 
Ccjmmand for SU antenna alignment. 

And, there's a fallback channel provision on the SU which 
offers built in redundancy. In tlic event an SU cannot 
ctjinmunicate with its primary AP, the SU will intelligently 
search for a pre-programmed fall bai:k AP to communicate 
with, 'Ibis feature allows the network operator to actually 
sleep at night knowing that each user’s network link will still 
Ik* u[) in the morning. 

But there are two Tea lures that are super cool, especially if 
you are familiar with insuilliiig wireless netwxrrks. First, there 
arc* internal dual polarized antennas that are softw'are switcliable 

— yes, you can change the polarity through the softw'are 

interface! ^Second, the radios have built in site survey tools tliat 
allow you to check for interference (see Listing 1). 

Listing I: Site Survey Results _ 

^rvey 3 v 

Running site survey for 30 secs, 

Frens [space! then fentetl to stop 
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Vectical Polaris:ation Channel is clear if avg max < 

-92dBiii 


freq 

max 

avg 


freq 

max 

avg 


Hhz 

dBm 

dBm 

clear 

Hhz 

d£m 

dBm 

clear 

5724 

"87 

-97 

‘no* 

5788 

-93 

-99 

yes 

5728 

-81 

-95 

*no* 

5792 

-93 

-99 

yes 

5732 

80 

-95 

*no* 

5796 

93 

99 

yes 

5736 

-79 

-95 

‘no* 

5800 

-93 

-93 

yes 

5740 

79 

95 

‘no ‘ 

5804 

-89 

■99 

*no* 

5744 

-80 

-93 

*no* 

5808 

-88 

-97 

*no‘ 

5 748 

'82 

-97 

*no* 

5812 

-82 

-97 

*no* 

5752 

"91 

-99 

‘no* 

5316 

-81 

-95 

‘no* 

5756 

"93 

-99 

yes 

5820 

-80 

-9t 

*no‘ 

5760 

'93 

-99 

yes 

5824 

65 

80 

‘no* 

5764 

-93 

-99 

yes 

5828 

-57 

-77 

*no‘ 

5768 

93 

99 

yes 

5832 

-57 

'85 

•no* 

5772 

93 

99 

yes 

5836 

-57 

-83 

-no‘ 

5776 

'93 

'99 

yes 

5340 

-57 

-83 

•no* 

5 780 

-93 

-99 

yes 

5844 

-59 

■85 

*no‘ 

5784 

-93 

-99 

yes 

5848 

-63 

-79 

*no* 


Security 

With all tlie talk about security over WUFi, you may be 
concerned about the security offered by a wireless solution like 
this. I'm not. First, because these radios are proprietary, it will 
rake a lor more effort for someone to figure them out. Second, 
the radios will only talk to another radio that it knows the 
hardware (aka MAC) addrcs.s of. Third, Trango has built these 
radios with security in mind. I have a lot greater concerns alxmt 
other attacks on our network than 1 do alx>ui someone entering 
in through iliis wireless entry point. 

AppleTalk 

If you are still using AppleTilk protocols in your network, 
no worries. These radios can handle them. Since AppleTalk uses 
AARP, you wQl need to turn the multicast packet switch to off 
(disabled). Once you do that, AppleTalk Phase 1 and 2 pass 
traffic with no problems. It's pretty <xk>I to pull up a zone at my 
house from the office ... in fact, 1 have a Horne Automation 
server at the house that stores my MP3s, and I play them in 
iTunes over File Sharing on a machine m my office. 

Broadcasting Changes 

One of llic ax)l things ahotit the.se r^idios is that you can have 
the Access Point Ixoadcasi changes icj die AFs. Tliis is, obviously, 
especially u.seftil if you have many SUs talking to the AP ... and 
again, shows die heritage of this radio Ixdng targeted for ISPs. 

What’s an Insi all Like? 

These radios are intended for ISPs l(x>king to deploy in their 
network. On one hand, that's great lxx:au.se that market won’t 
tolerate a lot of problem.s ... die radio.s need to lx* robust. The 
flip side to this is that this Ls not a prcKluct that is currentty being 
marketed to the end u.ser In pan, thafs because you should 
have some expertise when deploying it. 

Unless you are an expert yourself, you should talk to 
someone who i.s. Our experience with Westlink Wireless 
sliowed die importance of this. Eddie's ability to size up the 
network envhonment and to work out the kinks was important 
to our install (mostly because we were doing point to point to 
jxiint instead of point to point as most people would.) For 


example, 1 never would have known that it was better to fiave 
an AP and SU at David's instead of two AP's, 

You necxl to make sure of ^several things. First, do you have 
radio line of sights From my previous article, radio line of sigfit 
takes into account the shape of the zone that the radio waves travel 
in. This is called the 'Treznel'’ zone. Basically, tlie radio waves travel 
between the antennas covering an area that is sliaped long an 
elongated football. In other words, die clearance that you need 
halfway between the antennas is greater than right at each antenna. 
In many case>, lliis means Lliai you are at an advantage if one of 
the antennae locations is at a higher elevation tlian the odicr. 

You also need to make sure that you aren't trying to send 
the signal Lhrougli or near items that could cause interference. 
For example, the metal flashings around die loji of a chimne^y 
might be a problem if you are mounting the radio to a chimney. 
Or, if you were thinking that you could should the signal 
through foliage, some may be more tale rant than others. (1 
learned the hard way that pine trees are really tough to deal with 
and should always be avoided.) 

My recommendation? Either plan for a bunch 
experimentation and learning, or lietter yet, liuy the radio 
through a reseller like Westlink Wireless so that you have 
somewhere to consult if you nin into issues. 

The Interi ac e 

One of the things that I didn't like alxiut the Lucent solution 
that 1 had was that it re(|uired that 1 talk to it through a piece of 
Windows software. Virtual PC, as always, came to the rescue so 
that 1 could use my Mac to configuie the radios .., and VirtualPC 
6 is better than ever in tliis way. 

Tlie Trango radios, iliough, can lx configured not only 
tlirough a web interface, laut also via telnet. A quick overview 
of the command set gives you an kleit of all that you can do with 
this interfaccv 

Listing 2: Telnet interface for IVango Access Point 

' ALL 

? IcommandJ 

cd [., |Dialn|net|cf Ifw|sg] 
date (montli? <day> <year> 
logout 
reboot 
aysinfo 

<backupI restore) 

EW [<sw #> <oTi|off)J 
time <hour> <tiiln) <sec> 
updatefiash 

| fpgaimage | EUraainiiriage [ Eufpgaimage [ Ry^stfimsettingl .^udb 


* MAIN 

bcastscant <ailjsuid> (ch#> <h|v> [<ch#> <hjv> ... 
bcaetsuimage <ailjstiid> <re£iilat|ffl£t> (target hw_ver> 
bcastsuimage [stop] password 

_pasEVord (new password) (new pas.sword) 
set sold (id) set apld (id) 

set baseid <id> set Ip (ip addr> 

set defaultopraods Uplsu] 

set defaultupmode off set mir [on| off] 

set mir threshold (kbps) 

set rssitarget (threshold) (fade margin) 

au <Buid> [nonstop] su all [nonstop] 

SU changeohannel (alL|suld> <ch#> (hjv> su 
fllve|powfit:off I prior i ty] 

SU (ping| I(ifa|jatatus> <suid> su reboot <all|suid> 


1 

date 

help [eonmiand] 
opmode [ap] 
restart 
syatemsettlng 

time 
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s\i r^st&rt <allUuid> su testrfiink 

<al]|suid> fr] 

su paverleveling ^alljatiid) [target dE] 

su sv <suid) ^sv <an|ofr> sudb fdlaad | view] 

sudb add <suid> <pr|reg? <cir,kbps) <jiiir,kbps> <devlee id,hex) 
sudb delete <5uid> sudb modify <suid> 

Celt Imir> <kbps) 

sudb modify <suld> <su2su> <group id,hex> 
sudb view 


' NET 

ping <ip addr> tftpd [on|off] 


* RF 

cf2ef ap [default I<si£e>] freq scantable 

freq channel table fret} writescan l<ch#> 

Ch|v>] ... 

freq wtitechatinel [Cch#> <freq>] ... 

freq <ch #> <h|v> polar <h|v> 

power set <dflra) power table 

rfreport [reset] rfrxrhtefihold (off| 

S€j-75|’70 J’65> 

rfrxtbteshold table 


* FW 

malnupdate fpgaupdate 

• SS 

survey (time* sec> ^hjv> rssi <ch if) <h|v) 

apEeatdi <seca> <chf) <b|v) [<ch#) <h|v>J.., 


The Good, The Bad, and toe Ugiy 

In general, 1 love these Trango producUs. You can't !x.4ieve 
how useful il is to change [Kjkirity of antennae in software ... or 
to do a site survey from a telnet interface. More importantly, 
these are robust radios that are serious business, and I’m thrilled 
to have them in my network. 

I’liere arc a couple of things that got to me on these radias, 
and are worthy of mention here. First, and tht^se are minor, tlie 
K[-45 jack on the power injector is [raekwards. The dip is against 
tile wall, and tl ctin Ix? very difficult to puU tlie cord out without 
having a small flathead soewdriver. Also, the arm that the radio 
mounts on c^otild Ixf easier to articulate, but it’s not bad. 

Tlie one tiling dial I imly despise in diese radios is what I can 
Ix^t descril)e as an over the top security feature. Once .set up, you 
c'an really only configure these uniLs fixim one side of die connection 
because it limits wliem you am log in from, Kememl-ier, these things 
were designed for ISPs who deploy one or more APs and then liave 
teas of SUs. 'ITie Iclai Is that you wouldn’t’ want a LusUimer to ix.* 
able to telnet into a SU, so cvoylliing needs to happen from the 
hc%id end side of diings. Now, it is possible to log in from the SU 
side, iTut you have to do so within the first 30 or so .seconds from 
when it's lx?en power tYcItxJ. This is cjuitc llic train and for me, 
almost useless as I want to manage tilings remotely, not on site. 1 
have no problem with this feature being available as a software 
switch, but even if I w^cs an ISP, I wouldn't want diLs fc^aluie turned 
on by default ™ I want to be able to configure these things from 
both sides! And, this one sided nature doesn't stop there, you on't 
even ping the radio from the dienl skJe. Tliis meaus tliai an ISP 
om'i even ask dieir cusiomcT if they can ping a radio w'hen the 
connection is down! What a pain for those in tech support who 
have chased problems only to find that tfie dient unplugged a cable 
somewhere. Unfonimaiely, Ixxiaiise it would mke a complete 
rewrite to fix, 1 don't expect this feature to go away soon. 


Another limitation is tiieir use of ‘'opmodes”. Radios are usually 
configured when they are not nmning in either the Actress Point or 
Subscriter Unit "'opmcxle’". Disable die opmode, and you disable the 
link. Ena We the opraode, and you can't configure die unit. 1 his is 
different from other types of radios that seem to be able to do both. 

What’S Coming 

There are some new things coming down the pike on the.se 
radios. A new firmware upgrade will have SNMP capability (this 
will be a free upgrade). And, there’s a dual-band version 
(5-3/5-B GHz) coming soon texj. La.stly^ expected in May 2003^ 
there will be a true point-to-point version of the radios, which 
may intere.st many of you. 

The End Resijlt 

Frctof is in the pudding, right? 

These radiixs are fast... I'm seeing communications at under 300 
microseconds (not milliseconds) between the radios. But, a radio 
ping is different from an IP ping which is what we really aire alxjuu 

In my point to point U> point setup, I came from my older 
set up doing 1.4 mpbs with 30 millisecond latency to a new set 
up of 6-8 mbps (depends on the direction) with 5 milliseconds 
latency. The speed is so diffeaml and so much l)etter tiiat, using 
Retrospect Server, Tin actually now ainning backups of my 
home computers to tape drives at the office. 

Dex^sn't get much better than that. 
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COCOA 

DEVELOPEMEMT 


By Ron Davis 

Adding Regular Expressions To Your Cocoa 
Application. 


Using MOKit to add the ability to match 
regular expressions in Cocoa. 

Does your application need to parse data out of a bunch 
of text, or niatcli strings tiial can vary some, but have a 
regular syntax? Do you have a Find command in your icxi 
editor? If you do you need to add regular expression 
maicliing to your app Regular Kxpressions are textual 
representations of strings inaicti pailern. They go i>eyood itisi 
finding a string and let you do things like find a siring that 
begins and ends wrili certain characters, but can have 
anything in ihe middle. Or a string ihai contain four numbers 
followed by a letter. 

IVe l^ien around the Mac a long lime and never really 
thought alxHit grep or regex or other commands I hat use regular 
expressions. Hut OSX changes that. Every UNIX geek ota there 
know.s ufxiut grep anti it various offspring. Scripting languages 
like Fcrl use regttfar expres.sions as well, I thought I neetied 
to learn about them. Once T did \ wa.s lux iked, anti wanted to 
use them in my own applications. Tliat lead me to Mike Ferris* 
MOKit, a Qk cxi fnimework that lets you easily deal with regular 
expressions in your ap])]kalion, 

iNTRODtTfTION TO ReGITAR EXPRESSIONS 

We’ll start witli a i|yick look at regular expression syntax 
for those of you who have no idea what I'm talking about. 
The introduction will be fast and .shallow. If you need more 
information check out the URL in the Bibliography at ihe end 
of the article. 


Symbol Meaning Kxampte 


character 

The character tyjxxl, 
w'ith the exception of 
special chanicters. 

A is a, b is b, etc. 

[chantaer - 
character! 

Any of a range of . 
characters 

fa-d] = a,b,c, or d. 

■ 

Period matches any one 
character except line 
breaks. 



Matches any digit, 

0,]. 2, 3.4,5.6, 7, 8.9 i 

\r^ 

return 


\t 

tab 


\ 

llie escajx* character like 
in printf. Putiing a .slash 
in fnjni of a special 
character allows that 
c'hameter to lx* matched. 

\, matches a period. 

\\ matches a slash. 

7 

0 or I of llie previous . 
characters 

CJ?i, matches cat, or ct, 
but not caaL 

m 

0 or more of the 
previt)us cliaraclers 

ca*t, matches ct, cat, 
raat. caaat. 

+ 

i or more of the 
previous charatters ; 

ca+t, matches cal, caai, 
caaat, hut not ct. 

A 

any charac ter but the 
ones after the carat. 

tAr 23 ) any c'hamcter 
but r, 2, or 3- 

pattern | 
pattern 

match pattern or pattern. 

ca |l, matches ca t)r t, 
hill noi cat. 

(pattern) 

Matching: treats what is 
in the parenthesis as a 
single chumeter, 
Searching; delineates the 
infonnation to lx* 
rememixred in a find. 

(ra)*t, matches cat, or 
cacat, but not cL 
cC*?)[f on string coat, 
returns '‘oa”. 


'Ilie last panem there gives you a litni that leguiar expression 
cm be used in two different ways. One way is niiitching, w^here 
you liave a siring and you want to know if’ it Ls equal to a regular 


Ron Davis h a long time Mac programmer, having worked on everything IVcMii Virex Ami-Virus to Code Warrior. His day job Is wc^rking for Alsofe and 
his evening j(>l> is R.A.D. Productions, makers of Suck Ji Down and l-indcrBye. 
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expression. This reriims » Boolean value, eiiiier ilie siring matches 
or it doesn't. Hie oilier way to use regular expressions is to find a 
substring or strings in a longer siring. Wfien you do this you give 
an expres.si(>n and you specify what part of die niatched string you 
warit I Kick by placing that part in parentheses . 

Let’s look at an example or two, Say you let the user input a 
seven digit zip code and you want to make sum diey didn't put any 
letters in ilicTe, You could get their input string and compare it 
against die regular expression which matches 1 or more digits, 
but wouldn't match an empty string, nor one with letters in it. 

Now say you have an HTML tag for a link like <A 
I lKLF=http://www.radproductions.net/>RAD prcxluctioas</A> and you 
wanted to pull out the URL. You aiuld scarc:h with the regular 
expression '*^(,*?)>” and you would get back 
http://vvww.radpfodLicfions.net. You may wonder why the ? is diere. If 
you just put which means match 0 or more ckaracters, you get 
to die end of the string because quotes and lirackels are chanicters 
tcx). Tills is called a greedy search. Putting die ? tells it to only search 
until it finds the next ]>arl of the expression string. 

MOKrr 

MOKit is a CaKtia framework written by Mike Ferris. It 
contains some text manipulation classes, one of which handles 
rx:gular expressions. Hie underlying regular expres.sion engine 
is actually a standard pac kage written by Henry Silencer and 
used in one form or another by a lot of interesting things such 
as icl and perl. MOKit classes are “not public domain, liiii they 
are free” according to the web page. The ccxlc ain be 
downloaded at http://www.lofax.com/FreeStLjff/MOKit.htmf You can 
gel Ixith compiled frameworks and die source to MOKit. Version 
2.6 was used for this article. 

MOKit has Iwo main parts, classes for text conifiletiun and 
cla.sses for regular expre.s,sions. Well only talking alxiut the 
regular expression classes here, The.se classes are 
MORegularExpression and MORegexFortuaUer. 

MOUegularHxpression is the main class for handling the 
evaluation of reguhir expressions, it is the one well use in our 
sample code. Heixf's its declarution. 

Listing 1: MORegnJarExpression interface. _ 

^interface MORe^uiarExpressioji : XEObjert <NSCc}pyiii£. NSCocling> 

[ 

^iprivate 

KSStrlng •_exprefjalonSiring: 

NSString 

NSRan ge _la s t S u bexp r u k sionRan ges 

IH0_REGEXP_MAX_S0BEXPRESS!0KS]: 

void *_coiEpiledExpreBfiior: 

BOOL _ignoreCase; 


+ (BOODvalidExpressJonString: (NSString *) expresaionString; 

+ (id) regularExpreasiorLWithStting: (NSString *) 

exp r ass ionS t r ing i gnor eCa s e:( BOOL )J gn o rt CaseFl ag; 

+ (id)regularExpressionWlthString;(NSString *} 
expressionstring: 

* (id)initWithExpresslonString:(NSString •JexpressionString 
ignoreCase:(BOOL)ignoreCaseFlag: 


Adding Rfjcuiar Expressions To Cocoa Appucation. 


- (Id}initWithExpreasionString:(NSString *) 

exp r easionSt ring; 

- (NSString ‘)expressionString: 

■ (BOOlOmatchesString:(NSString *)candidate: 

(NSRange)rangeForSubexpreasionAtIndex:C unaigned)index 
inString:(NS St r1ng ‘]ca ndidat e; 

* (NSString *)flubstr ingForSufaexpressiotiAtlndexr 

(iinsigni^d)index inString: (NSString *)candidata; 

- (NSArray *)EubexpressioiisFor St ring: (NSString *)candidate: 

@end 

As you can see, it is a fairly simple class. To use a regular 
expression in your code you create an instance of this class. 
If you need to keep it around, using the 
initWithExpressionString methods will probably be easiest. If 
you're just going to use it in the scope of a single method, use 
the cia-ss methods regularExpressionWilhString, stj you won't 
liave to deal with releasing. Both of these method.s have twins 
that take an ignoreCase parameter which, if set to YES, will 
cause evaluations to ignore die case of the characters in the 
expre.ssion and the search string. If you don’t explicitly set 
case sensitivity then searcheii are case .sensitive. Here’s an 
example of how lo create an expression for finding HREFs in 
a string of HTML: 

MORegularExprMission* llnkURLExp = [MOReguiarExpresslon 

regula rRxp rpRsionWithSt fin 
Si 

HREF-.*K/A)'‘ ignDreGaee;YESj; 

If you want to make sure Uie expre.ssion yt)u create is valid 
you vjn call the class method valicfExpressionString, which will 
return YES if the expressirm is a valid regular expression. If you 
want to know what an MORegularExpression object's expression 
is you can get it from the expressionstring accesstir. 

Now we can actually do stjme evaluations. As I said 
previously, there are two ways to use regular expressions, to 
match a string and to find a sub-string. If you have a .string and 
you want to make sure it Cfjnfimns to the regular expression you 
created, you can pas.s it inU> matchesString and the result will tell 
you if it matches. This is what MORcgexFormatter dcx;s. It is a 
formal I er you ca n add to a field and it will validate the value m 
that field by the regular expression you give it. 

tietting sub-expressions is interesting. If you just want to 
fmtl die location in die target string of a sub^string, you ran use 
the rangeForSubexpressionAtlndex methcxl. If you want die 
whole sub-string back as a new NSString* you use the 
substringForSubexpressionAtlndex, passing die string you are 
searching for in the inString parameter. The index is which value 
in parentheses you want hack. 'Diere can be 0 to 20 sets of 
parentheses in a MOKit expres^sion, and the index indicates 
which one you want the range for. So you could create an 
expression like VA HRFF=( .*?)>(.•?)</A>’' to search for a link in 
an HTML page. If we usckI die HTML in listing 2, and you asked 
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for index 0 you would get the whole HRBF tag: "<A 
HRFF-http://wwwjadproductioas.net/>R*A.D, Produaions</A>". If 
you asked for Index I, you'd get the link back 
‘*http://www.^adp^oduclit^as.net/^ IF you asked for index 2, 
you'd get back the text “R.A.D. Productions". 


listing 2: Sample HTML 

<HTML> 

<TTTLE>R.AJ). Productlotifi Home Page</TITLE> 

<BODY> 

<A ilRKF=4lltp://\flAfWVJadprodUdiO^^^ Frodur-tlfinsi</A> 

</BODY> 

</HTHL> 


In a tiuLslicll, that is all there is to finding sub-strings with 
MOKegularFxpression. The last mciliod in the interface, 
subexpressionsForStfing, is there for backwards comi>atibility and 
Pm not even going to explain it. 

There is one tricky diing alioui using MORegularRxpression 
in a large amount of text. WlitU happens if you want to find 
every link in an HTML page? substringForSubexpressronAtIndex Ls 
only going to return die first occurrence in the string. Turns out 
there is no way to say, start searcliing at character n in the 
candidate string. What I did was truncate the string after each 
search to find the next one. Here's my code to find all of the 
links and their URL in an HTML page. 


Listing 3: finding all of tlie li nks. 

- (void)haadictnmHNSString-)inHm 

I 

MORegularExprefifiioh* boThSxp “ 

[MORe gula rExp ra sslon 

reft idar Expr as sionWlthS t rin£: 

ignoreCasc:¥ES]: 

MOReguiarExpreflsion* startStopExp = 
fMORegularKxpression 
rftftu 3 a rExpressionWitbstring: 
ri“<HTML>£.*?)</HTHL>“jr 

NSString* result " oil: 

NSRange range: 

NSString* curString * fstartStopExp 

sub s t rin gFo rSubex p r es s1onAt T nd o x:1 
inString;itl3^'I1^Ll; 

do 

t 

rango " [bothRxp rangeForSubexpresslortAtIndex:0 
inStrlng:curString ]: 
if £ range,length > 0 ) 

( 

HSString* ORLString: 

NSString* UnkStting; 

NSURL- fullURL: 

result - [llnktlRLExp 

aubfit rlngForSubexpresslonAtlndex:0 
inString:curString]: 

URLString “ IbothExp 

sub stringForSubexpresslonAiIiidex:! 
inSrring:curString]; 

fullURL “ [NSm mWlcbSt ring ;UaLSt ring 
relatlveTalJRL:baseURL]: 

URLString - |fullURL absoluteString]: 

linkstring = IbothExp 


substringForSubexpteaslonAtIndex :2 
iuString:curString]: 

if ( linkstring = nil || 

URLString ” nil || 

((linkslring length]“ 0) || 

([URLString length]— 0) ) 

{I else 
I 

[self addURL:URLString withText:llnkSlringJ- 
J 

curString - [curString aubstringFromlndex: 

C range,location + range,length)1: 

I 

1 

while ([curString length] > 0 H 

range.location != NSNotFound J: 

( 

A little explanation. The mctluxl is in a class that has a 
method addURL. 'Ike class also keeps two arrays, one for URks 
and one for the link text. When you call addURL the URL and 
the link string are added to the arrays for future reference. The 
class also knows whiit the URL of die page you are parsing is, 
and saves it in a variable called basaURL. 

The first tiling the melhtjd does is set up our regular 
expression for links. Then it makes a new string that will 
contain only the texr between the <IITML> tag. You can use 
this to limit ilic search to just a certain pan of the page. Then 
It sets up a loop, which will always execute once and will end 
when we don’t get anything back from our search, or wc run 
out of HTML to parse. Inside the loop we first try to find our 
expression's range in die HTML, If it isn’t there, were done. If 
we fiofl somediing, then we use our expression to get the 
sub-string fiir the TfRT.. Some times a LfRL will be relative, so 
we use NSUKL witli the page's URL to create a full URL. 'Lhen 
we ask for the second index, which is the link text. If we get 
both, we add it to our list. 

If we find something, then we need to search from the end 
of the siring we found. So we create a suli-string from our 
current HTML .string, that starts at the end of what we found and 
ends at die end of die current string, lliis effectively chops off 
everything from the begtmiing of Uic siring to the end of what 
we just found. Then we loop. 

Hopefully you've seen the coolness of regular expressions 
and want to use them in your CcKoa apps. MOKit makes this 
easy and is easy to use. So go to Mike Ferris’ website and 
download it and add regular expres.sions to your app. 
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UNIX SECURITY 


By Marcelo Amarante Ferreira Gomes, Rio de Janeiro, RJ, Brasil 

Introduction to Unix security concepts 


Security can only he achieved when you 
know its basics. 


Why Unix? 

By now. most, if not all, MacTech readers know ihai Mac OS 
X tlerives from Unix. It may not ju.si amther Unix, since it is 
very dilfert-ni From mosi iJllier unlxes in many aspects. But ii 
defmitely is Unix* So, if we are to write gcxx! software for it, 
e.s}K*cially if w'e \>^mi that software to be setaire, we need to know 
more Elian just the basics the Unix side of Mac OS X. 

'Itiis is the first article of a series, written with the intent to 
give you an idea of what computer security really is about, and 
how to enforce it. We will emphasize the f)rogiammer side, 
hoping to help you WTile safer a[>plkatians; but the materia] in 
lUis series will also lie of use to system adminisimiors and even 
power users. 

'Ihese articles will fcxus on Mac OS X, since old-timers 
already know Classic Mac OS, and itiosi newbie.s are only 
iitterested on X* To belter explain M;tc OS X concepLs, tliouglc 
it is sometimes easier to talk alx)iJi Unix eoncepts in general. 

7'here is a loi of historical material in this series of iirtities. 
This tuaterial is here mit only so you can heiier understand how 
things evolved and why they arc the way iljey are. It will also to 
let us learn from ihe errors tjf the past and avoid rejieating them. 
You will (Tien see typical attacks crackers tised and how security 
evolved in response to ihem. 

'rhis hisiory-telling at>j)roucli has the added benefit of 
passing along a little bit of Unix culture to die-hard Classic Mac 
OS programmers. In order to write successful Mac OS X 
software, traditional Unix programmers should learn a bit of 
Classic Mac OS culture, while inidilional Classic Mac OS 
[irogrammers should have a IcKik into Unix culture. For a 
discussion on this subjen, see (Ciomes 2001). 

This first article contains no code at all It w^ill start by 
defining computer security and then focus on Unix users and 
groups. You wall see how^ itsers and gr<mps are implemented in 
a typical Unix .system, ht>w' different the Mac OS X 


implementation is from lire typical, and the impact that each of 
these subjecLs has on tlie security of a system, 

DEnNiN<; CoMPtriJiK Security 

Unless youVe coming from Mars today, you have probably 
already lieard alx>ul computer viruses, Trojan horses, DoS 
(Denial of Service) or DDoS (Distributed DoS) attacks made by 
crackers agaiast Iniernel sites, l>usiness offices, or even home 
mad lines* You tiiighl even have already been plagued by some 
of the,se. Many people think of these threats whenever they 
hear the term compiiler .set tirily. While it does include concern 
alx)ut these, the security of a computer system is much more 
complex than that* 

We could define tx>mpuicr security as the task of enforcing 
just one general rult?: Any given user should only be able to use 
a given eomj)Ltting resouree if that user is allowed to. A u.scr, in 
this sense, coukl be a real pc^rson, a prexess running in the 
machine, a libmiy' routine, or any entity^ that can use a computing 
resource. Let’s call this broader atneep! f>f user a cre.KtLwr, for 
computing resource user. As for the computing resource, it could 
l>e memorv' space, disk sj>ace, disk files, CPU time, passwt>rds, 
prcKesses, or just alxHJi anyihitig in the hardware, software or 
workflow. Even the concepts of using tir alhuing might mean 
different things, depemling on i tmiext. For instance, using a disk 
file may mean reading it, apiKMiding data to it. mtxlifying data in 
it, dcieling it, renaming it, or yet other creative mt'anings. 

In a multi-user system, security involves the task of making 
sure that any given pers<m will only Ix^ able to do w^hat the 
sysiem administrator decided that that paiticular user could do. 
I-xurnples of such sy.srems include Mac: OS 9 with the multiple 
users feature enabled, .Mac OS X, NT-hased versions of Windows 
tNT/20(X)/OCID» Ollier vei^tions of windows with network login 
enabled, any other flavor of Unix (Unix itself, Linux, 
(Free j Open) Nell BSD, .Solaris, AIX, HP-UX, Irix, etc.), and most 
mainframe environmetiLs. 

But even single-user systems have seairily concerns. Mac 
OS 8.x and earlier, Windows 9x, aging MS-DOS, dinosaur CP/M, 
or current ones sutii as PalmOS and Windows CH are all 
int iuded in this bundle. To fii tliem in our definition of computer 


Afarceio Atnararite Ferreira Gomes is an independent Macintosh, Unix anti Internet coasultant. He works mast of the time with his Bra?:ilian paitners, 
and plays most of the lime with his kids and/or hi.s Lombard PowerBtx>k that hiis llie single most iin|x>rtant OS in tile w^orld, Ix^sides mtxsl oilier junk 
in this industry'* You can reach him at suporte@inac. com... if you're lucky. :-) 


24 


INTKOUUCJION TO UNIX SKCLIRITY CONCEPTS 


MAcffHCH • April 2003 












■ Hardware-based string encryption — 
the strongest way to secure your software. 

■ A true cross-platfoim solution; 

1 key for 1 source code for Windows® 

Mac OS® and Linux? 

■ 99.97% hardware success" in the field, 
backed by [SO9001:2000 certification. 

■ A time-based licensing solution with 
a real-time internal clock—ideal for con¬ 
trolled beta testing, subscription, rental, 
pay-per-use or any time-based need. 

■ The widest range of licensing, module 
and netwoiicing models available. 

■ 24/7 hassle-free remote license upgrades 
and advanced H/\SP reporting tools. 

Pius, HASP4 is so easy to use, you'll 
wonder why you didn't choose it before. 

Open your eyes to real anti-piracy 
protection. Call 1-800-S62-2543 or visit 
HASP.com to request your FREE personal 
HASP4 Developer’s Kit today. 




PROFESSIONAL SOFTWARE PROTECTION 

' ... I f n 

North America: 1-800^562-2543, 847-818-3800 or HASP.us@eA!addirtxom international: -1-972-3 636^2222 or HASP.fl@eAladdifi,com 
Germany; HASP.de@eAladdin.com UK; HA5Ruk@eAladdin.com France; HASP.fr@eAladdin.com Benelux; HASPnl@eAladdin.com 

• Si/sinesi Software Alliance Olob^l Software Piracy Study, June 2002. ** Aladdin Itnowledge Systems actual hardwarp key statistics- 198S'2002 


Aladdin 

IfCUfilNlV |H> VILLA&E 


Protecting your software and 
business revenue is simply a matter 
of choosing the right solution, 

HASP4® gives you tougher, more reliable 
software protection than any hardware 
key on the market. With HASP4, you get: 


AJaddsn Knowtedge ^ysiemv. Ltd. HASP *s a tradeipark.of Aladdin Kncviiedge Systems, ltd. 














security^ you must remembt-T two tilings. First, even though 
there's at most one perstm using the system at any given time, 
that person is not necessarily allowed to access everyiliing. 
There may still be the concept of one (or even more than one) 
administrator and lower-privileged users. And just by adding an 
interface c-ard and a little software, single-user systems can 
(x^coine part of a laiger, multi-user and multi-machine system 
that we've come to call a network. 

The second tiling to remember is that our definition of 
cresuser is much brmder than just people; it includes any other 
entity that could be actively using computer resources. When a 
new application Is installed in a system, it actually l>ecx>mes a new 
cresuser in that system. As such, care must be taken so as to limit 
tile reach of the application to only diose resources it needs to 
use. At the same lime, we must not impose too restrictive limits; 
otherwise the application may l:>ecome so annoying to the person 
trying to use it, that it effectively l)ec:omes useless. 

With such a general tiefinition for security, one may get lost 
while trying to figure out whut all of its various meanings might 
be. And it's also easy to forget to state, or even implement, 
some of its implications. When we're dealing witli computers, 
tliere is often more thati one way of accx^mplishtng the same 
task. If a given task is not allowed to a given user, all possible 
means for that user to accomplish it must be blcjcked, either 
explicitly or implicitly. 

For instance, I have actually seen a huge security lireach in 
a Unix system shared among .students and faculty staff of a 
certain university, Of coursc\ students were not allowed to 
brow.se teacher's flies, since the teachers often used that sysLein 
to write upcoming tests to be applied to those same students. 
Most security measures were corrcaly set to block access to 
directories and files. But they have forgotten about the 
permi.ssi<in to have raw read access to the hard disk. One 
student then wrote a program to read the raw information from 
the disk and interpret the filesystem. Tliat way, he had actual ly 
bypassed the Unix kernel filesystem routines, and any security 
measure built into them, thus getting access lo any file in that 
disk, regardless of the permission lilts of those file.s. 

He c:alled his program thyndercaf. a pun on the name of cat, 
the Unix utility to concatenate and list the contents of files, 'llie 
student got so sc’ared when he realis^ecl die meaning of his 
findings that he never did take advantage of them, and stopped 
using hi.s program in the same day that he liad found an 
upcoming test. He has never bc'en caught. Before you wonder, 
111 assuro you: tliat guy wasn't me. 

'fliai episode teaches us a few iinp<jrtani lessons. 

1) There is often a way of accessing a given resource or 
accomplishing a given task that you may not have 
anticipated. Whenever possible, security should be analyzed 
by more than one person, so dial one may see possible 
weaknesses diat the other had overlookerl. 

2) Vou don't always need a iechnic:al solution to a technical 
problem. The simplest and perhaps most effective way of 


.solving this particular problem would have lx^en to liave 
separate and isolated (i.e,, not sharing the same network) 
computers for siudenis and faculty staff, 'fhat way, studenis 
would surely liave a harder time trying lo access teachers' 
files, instead of tripping upon them by accident. 

3) Conversely, some non-tcx:link^l problems can actually c^use 
technical ones. Tliis particular uni versify had a peritxiical 
computer security check-up procedure, and ti was effeaive. 
The problem was that it had not lieen followed, *I1iis is more 
a human resources problem than a technical c)ne. 

4) Last but not least, just because you have not detecied a 
security problem in your system, it doesn't mean you don't 
have one. Don't ever assume that your system is safe 
based tin the absence of alarms by anti-virus software or 
other intrusion detection systems. If you feel that 
something Isn't right, trust your instinct, use a little 
common .sense, and investigate. 

As a side note to all lessons alxive, you should be aware 
that this series of articles concentrates on a.spects of security 
specific to Unix-like systems and iheir im(>!ications on 
programming. If your particular concerns are more than just a 
little curiosity, you should read other material that also covers 
the social side and iniiny other non-technical aspects of security. 
Good sources are (Schneier 2000) or (Mitnick 2(X}2). 

Unix Users, Groups And User 1>ataba.ses 

The alx>ve definition of seciiriiy is just ttKi generic. So, let's 
try to narrow it down to secruriiy in a Unix-like system. Before 
we do, we need a few inoro concepts, 'I'his time, let's use more 
concTcle definitions. 

Our concept of cresusers is very broad. We can only talk 
about cre.suser.s if we have entities to represent them, fn any 
Unix-1 ike system, and that includes Mac OxS X, we have users 
and groups. Neither of these is even cltwe to the concept of 
cresusers, but they are very important in a Unix environmeni, 
especially for those dealing with security. For now, let's study 
the situation in which cresusers are indeed Unix users, leaving 
the case of application t:rc‘suscrs, process cresusers, and other 
Types of cresusers for later investigation. 

Each Unix user has a name, a numeric user ID and a few 
other properties, such as the directory lliey will use by default. 
By the way, Unix traditionally uses the term directory for what 
we ail I fokierm Mac OS parlance. Groups also have names and 
dieir own IDs, which may or may not overlap the numeric space 
of user IDs. As you might guess, a group is a convenient way to 
refer to more liian a single user. 

The concepts of users and groups may \yc implemented in 
a variety of ways. Traditional unixes have used the /etc/passwd 
file, li i.s a plain text file with each line representing a user's 
pRjpcnies in fields separated by colons, like die one in Listing 
1, You may notice that the line for die user www in tliat listing is 
split. This is in fact just a single line in the file. It appears split 
only because of magazine format. 
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*l1ie fields included in the /etc/passwd file are, in this orderj 
user name, encrypted password, numeric user ID, numeric 
group ID, a short description of who or what llie user is in real 
life, the user's default directory and his/her/its default shell If 
you don't know what a shell Is, just read on. 'Die section The 
Unix Command Line introditces this concepl. 

Some systems defined a syntax for the user description 
field, including sub-fields separated by commas or parentheses, 
hut those syntaxes were non-standard. Listing 1 shows an 
example of this file almost as it has always Ijcen. Tlie only 
exception is that the encrypled pjissword field contains an 
asterisk for every user. 

Listing 1: TypicaJ contents of an /etc/passwd fik- 

^ UiCT OatahiaM; 

* tTuii this file is mmiiJLi:U wJlcn the b running in singtc-iisir 

* moelc. At other time^ this infomytiun is hiindled hy lookupil By dchuJt, 

# iiKjkiijxl gels mfc>FniaUon fnim NeiTnfii, so rhis file will not be coustilieU 

# utiles you have eiiaiigcd |(mku[>d's tonfigumiion. 

## 

nobody: *: -2: -2:Unprivileged User:/nohoine: /noshell 

root:* :0:0:Sygtejn Administrator:/var/root:/bin/tesh 

daemon;*:1:1:System Services:/var/root:/noshell 

WWW: 70:70:World Wide Web Server:/Library/WebServet:/nosbeli 

unknown i *: 99:99: Unknown User: / nohojne: / noshell 

marcelo: *: lOOO: 1000: Maroelo Go«>es: /hoinc/marceio: /bin/sh 

As computing power increased, people started to realise 
that leaving all encrypted passwords in a single file, 


accessible by any user was a security risk. Since anyone that 
could log into the system could read this file, it was easy for 
a cracker to try passwords at will, or copy it to his own 
machine and later try to guess each user's password in the 
comfort of his home. All he had to do was lo write a small 
program to try each password in turn and see if, by 
encrypting it with the publicly available DES encryption 
rtmtines, he'd get the same encrypted password that was 
listed in that /etc/passwd file. 

Some programs tlien btreame available to automate iliis 
process, not only from crackers, but also from system 
administrators. After realizing the fragility of pas.swords that 
users chose, sysadmins peritxlically ran such programs again.st 
diciionaries of common Englisli words tc^ see how easy it was to 
guess each user's passwords. Some of them even tried 
permutations of letters in the username and user descripLion. 
The general idea Ix-fiind die algorithm used by these programs 
[>ecami^ known as the dictionary ailack. 

Most dictionary attacker programs were designed lo send e- 
mail to the users that had weak passwords. But since diese 
programs were shared among many people, they eventually 
ended up in the wrong hands. 

Crackers with almost nr> prior programming experience 
suddenly found themselves with powerful cracking tools in their 
hands. Dictionary attackers were not all dial hard to Iweak, and 
crackers soon found out how to divert to them the e-mail sent 
automatically whenever a new password was found. 
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Mac 05 X Killer Tips by Scott Kelby $19.95 Have you ever hod a buddy ask if you 

"want to know an easy way to do that?" They lean over your keyboard, click a few keys and you leorn an 
undocumented keyboard shortcut, a cool hack, a hidden system option, or [ust a cleaner way to get the job 
done. With Mac OS X, most of our favorite tricks are gone - it's a whole new game. This 288 page book 
is cover to cover tips and tricks for getting the most out of Mac OS X paguarj. 


Mac 05 X Disaster Relief by Ted Landau $23.95 The unexpected will happen, 

sometimes you'll need more than a manual. _MacOS X Disaster RelieL is the first trouble shooting guide to 
Mac OS X, written by Ted Landau (founder of MacFixIt). This book includes information obout Mac OS X's 
invisible files, third party troubleshooting tools, the smart way to install (or re-instoll) Mac OS X - plus tips, 
tricks, and troubleshooting techniques. 

COCOO PfOQfQittlttlttQ by Scott Anguish, Erik Buck & Donald Yacktinan $40.95 Over 1200 

pages the most comprehensive Mac programming book available for the new Cocoa APL Not for beginners, 
an essential reference for the serious Mac programmer. 

The Wirekss Networkmg Starter Kit by Adam Engst & Glenn Fleishman $24.95 

Practical advice ond step-by-step instructions for dozens of common tasks, troubleshooting advice to help you 
out of sticky situations, and coverage of Mac and Windows implementations of 802.1 1 b, 802.1 1 a, and 
802.1 Ig, and other technologies. 

MoStCtinO /I/IOC OS X by lodd Stauffer $26.95 Mac OS X is the most significant change 

in the Macinfo^ operating system since day one - you will have questions. Questions about troubleshooting, 
security, networking, data recovery, fonts, AppleScript, maintenance, or other subjects. There ore new 
technologies you've never seen before, like Darwin, shells, the command line, handwriting recognition, 
permissions, administration, firewalls, and others. At some point, you will wont this reference. 


Mat OS X for Unix Geeks by Brian Jepson, Ernest E. Rothman $16.95 Mac OS X has 

a BSD core. IPs a heady feeling to have the power and flexibility of UNIX on Macintosh, but if you are a 
UNIX guy you'll find there are some subtle differences. This book is a solid reference, to help you moke the 
switch. It shows you everything from your familiar user shells and directory services to building applications 
and system management - and how each is done under OS X T0.2 {Jaguar}. 


Mat OS X Hacks by Rael Dornfest, Kevin Hemenvitoy $16.95 Mac OS X presents a unique 

opportunity for combining traditional Unix hacking and Mac OS know-how. This book goes beyond the man 
pages, pulling the best tips, tricks, and tools from the Mac power users and Unix hackers themselves. 


Cocoa Recipes for Mac 05 X by Bill Cheesemnn $29.95 A step by step how-to on 

building an applicotion with Apple’s Cocoa ffamework. The 21 individual recipes, over 750 pages, walk 
you through the prcx:ess of building a single, industriol strength application “ while illustrating essential topics 
like handling menus, windows, data storage, user preferences, drag and drop, tables, undoAedo, and more. 
Wont to get started with Cocoa? This is the book. 









When people realized how eiLsy il was to break into 
systems like that, they thought of changing the users database 
fonriat. By that time, it was loo late to eliminate or cfiange the 
format of the /etc/passwd file, since way tcxi many applications 
were using it. 

The solution came frt>m noticing that very few pnjgrams 
actually used the password held. So, it could contain any kind 
of garbage, or even be left blank, and most applications would 
still work. The few programs that would get broken could later 
lx* fixed with little effort. 

Enter the concept of shadow password databases. 'Ihese 
databases were implemenmtion-dependent, sometimes consisting 
of binary files, as oppo.sed to the text-only /etc/passwd. Usually 
named either /etc/shadow or /etc/master.passwd, liicrc was still a text 
file, very similar to the /etc/passwd file, but containing the real 
encTypted user passwords. It wasn't readable by anyt^ne, except 
for the root user When there were binary files involved, tliey were 
compiletl from the /etc/master.passwd or /etc/shadow files. The 
/etc/passwd file was still there, and still readable by anyone, but had 
tlie look of listing 1, with no [vassword information. 

From then on, programmers were encouraged to get u.ser 
infonnation from library routines, instead of directly acx:e.ssing 
/etc/passwd or any other file. This practice made it pos-sible for 
system software writers to change once again the fonnat of user 
or group databases. 

Meanwhile, Sun had also developed Yellow Pages, now 
called NIS, and later came its evolution, NIS+, both 
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implementing network-wide user databases. NIS and NTS+ have 
become very pupular among many other Unix-like OS vendors, 
besides Sun. NIS seems to have spread a little more, periiaps 
Irecause it is simpler to implement and has been around longer 
than N1S+. These centralized network user databases 
reinforced the idea that programmers should rely on system 
library routines to obtain user information, instead of going 
straight to /etc/passwd. 

Other centralized users databases, to lx used throughoiir an 
entire network, have been developed. The most widespread 
today seems to be LDAP (Lightweight Directory Access 
Protocol), LDAP interoperates with many differenl 
environments: Unix-like, including Mac OS X; Classic Mac OS 
and even Windows, 

Groups on alst) lx defined in many ways, and have 
traditionally been implemented with a plain text file under tiie 
/etc directory, called /etc/group. Nowadays they are generally 
iinpleniented in the same database that keeps users, lx it NIS, 
N1S+, LDAP or s<)mething else. 

The traditional /etc/group file was even simpler than 
/etc/passwd, containing one group per line with colon- 
separated fields storing the group’s name, encrypted password, 
numeric grt>up ID, and a comma-separated list of users 
Ixlonging to that group. 


listing 2 ; Typical contents of an /ctc/group file.. 


# (iroup Daia ho.se 

# 

Nmt ihot liiis lilc is when the syMtfin b running m singjisuser 

# miMSe, Ai faher times ihis infirnmiioii is homUed by l(x>ku|xl By (k-laiilt, 

# lookups jteLs inftinnaiion fnim Nttlnft>, so tbb file will noi be coasiiiicd 

# unless yini have chanjitrii hxjkupd's configuration. 

t# 

nobody:*:-1: 
wheels*:0i 
dnemon:':1:tggt 
sys root 
tiyi*:4iroot 

operator:’:5:root.marcelo 
nailL':6: 
bin:*:7: 

staff r *::root.msreel o 
guest:* ill :tool,»arcclo 
uuep: • : 66:niarcelo 
WWW:*:70: 

marcoto:*:lOOO'marcelo 

It didnY take loo long for people to alxmdon the concept of 
a group password. It just dixsn'l work. When tiie password 
leaks, nobody lakes resixjnsibility. Bedsides, it was only useful 
while systems allowed processes to nm with the permis^sions of 
just a single group. Soon omc versions of Unix and Unix-like 
.systems that allowed a single process to have the added 
permissions of all groups it could belong to, in fact rendering the 
concept of group pa.sswords useless. 

System administrators in charge of the few systems that 
actually supported group passwords were encouraged to disable 
it, by changiiig the encrypted password to an asterisk. The 
typical /etc/group file ended up kx)king like listing 2. The group 
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paN.sword field is still there, even in the modem Unix-like 
systems we have nxiay. 

Users And Groups, The Mac OS X Way 

Mae OS X has a its own means of storing user and group 
databases. The /etc/passwd and /etc/masterpasswd files are still 
there, but only for times when network service is unavaila[)le, 
such as in single-user mamtenance mrxle. 

For daily usage. Mac OS X employs a daemon, called 
lookupd, that in turn gels its information from anullier daemon, 
called Netinfo. Unless you fiddle with lookupd's configuration, 
Netinfo is the definitive source of user information for login and 
other authentication purpf.)ses. 

However, Mac OS X may l>e configured to use N1S/NTS+, as 
descrilxxl in (Bresink 2002) for versions prior to 10.2 (pre- 
Jagiiar). As of this writing, in Noveml>er 2002, the use of NIS 
with Jaguar is discouraged, bui a NLS plug-in for Apple Directory 
Servit:es is already under development. A similar tweaking may 
Ix' used to make it look up the needed infarmatit>n in an LDAP 
database, or even files such as /etc/passwd, aJtliougli you will 
prolxihly need additional software to integmte these databases 
10 kxjkupd and/or Netlntb. Apple says Jaguar has a better 
integration to LDAP, but I wasn't able to try it out. 

Make no mistake, iliough. Netinfo is much more than a 
mere users database. It consists of a sophisticated 
information repository, having a lot in common witfi LDAP, 
and is used in Mac OS X to hold lots of other configuration 
options, besides users and groups. Even information related 
to a user t)r a group is not limited to traditional /etc/passwd 
information. For instance, Mac OS X allows each user to have 
his or her own network-shared directory. The path to that 
direcU>ry is stored in Netinfo, along with all other 
information about that user 

Netinfo is similar to N1S/NIS+ and LDAP in that they are all 
capable of maintaining a single database to he shared among 
many macliines. Tlius, any user can log into any machine in the 
network by using his/her own login and password. This won^i 
cause major headaches to tlie network administrafor, since he 
has a single master users database to take care of. 

You can have a better feeling of what Netinfo is by reading 
(Apple 2001) or the manual page alxHii Netlnfor just type man 
netinfo at the shell prompt (see the section The tlnix Command 
Line below for wliat a shell prompt is). You could also run the 
Gill interface to Netinfo, Netinfo Manager. It can be found 
inside die Utilities sub-folder of your Applications folder. To play 
it safe, make sure to backup the Netinfo database in 
/var/db/netinfo/local.nidb and the traditional Unix users database 
in /etc/passwd and /etc/master.passwd. But keep in mind that the 
recommended utility for manipulation of user and group 
information is still die Users eontrr>l panel. 

You should note that Netinfo itself, as well as NIS/NIS+, LDAP 
or any otltcr nelw(>rk-based users database, may pose a security 
risk to your system. When die conc:ep! of shadow passwords was 
introduced, the Idea was to eliminate the possibiliry of any user 
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having access to any tjtlicr ufsers' passwords, even in encrypted 
fomi, to avoid the dictionary attack. 

Willi tlie introduction of Netinfo, crackers once again have 
iJiis possibility once they obtain network access to the Netinfo 
server. Tin sure you will understand why 1 won’t descritx.^ here 
how such access can l:»e obtained anti wlial good this access can 
do for a a-acker. lliose of you wiUi more experience in network 
security probably already have an idea of how^ ii c:an Ix! dom. 
But I will indeed tell you whar measures you can take to 
minimize your risks. 

The choice of strong passwords and good system 
confignraiion can greatly reduce this risk. Tfie use of strong 
passwtirds, containing non^alphanumcric characters is always 
recommended, regardless of how you store and manage them. 
You could even require users to use such passwords if you give 
them only tlie choice of changing their passwords through a GUI 
frtmuend that checks for the weakness of password.s before 
committing tlie change. 

A good pitssword. for in.stance, could l)e “h4CiS:3rZ, GO 
hOW3!". It has upper and km^crciise letters intermixed, mimetic 
and punctuation chambers, and has a mnemonic meaning - try 
to read ii as backers, go bomef Of course, this one might Ix" 
difllculi for you to rememl^er, but you can pmbably make up a 
password like ihi.s that yoifll lx able to memori7:e. If your 
memor>^ is really good, you on even u.se truly random 
passwords. Just make sure not to write your [xissw'ords down, 
or you 11 lose most of the effectiveness of password protection. 
Another hint: don’t use the alx)ve password or any other 
passwt^al that lias been published. Many jKxiple know them, 
and tliey will probably make it into many crackers’ dictionaries 
for tlieir next dictionary atiuck. 

Qinfigiiration changes may make it harder or impossil)le for 
the cracker to get the information he/slic wants direnly from the 
server. For instance, to limit the reach of crackers trying lo access 
the database, you may add a firewall to blexk actess to the [X>ris 
used [jy Netinfo. Early versions of Netlnlb running on NeX1’ 
systems used port.s 716 through 719. Apple seems to be using 
765-76H and 1033 for Neiliifo and port 776 for lookupd. You can 
investigate what ports your system is using liy issuing the 
command netstat -a at the command line of your server. By 
blocking ihe.se ports from the outside, you will limit your 
headaches lo inside crackers. Ifs always a good idea to limit 
access to other services as wd\ (in particular, kPC, port 111). If 
you don't have a firewall, you could install a packet filler a 
similar blcKkiiig mediunism. 

If you run a single machine, noi meant to lx a sem^r, Apple 
ha.s done its Itomework and tULKle Netinfo database a hii s;ifer, 
by setting the trusted^networks properly oi' Nethilb’s r{)oi 
directory to an empt}^ value. This should render Netinfo 
inaccessible from outside machines, altlicxgh Td prefer to have 
the f)ons hkxked. Notice that you can still have l(K:al crackers. 
Anyone that has access to your machine can access Netlnfo's 
database. 1his is less of a prol)lem, since if any bad guy has 
access to your machine, die battle is already lost. 


The Unix Command Link 

Rven though Apple makes it hidden from the average user, 
Mac OS X has a comnianddme interface. It's in this interface that 
we find most of the similarities Ixcween Mac OS K and tjilier 
Unix-like systems. In that same Applications folder, you'll find the 
Terminal application. Fire it up, and lei's see how the Unix 
command line feels. 

Hie prompt that you get comes from anoilier application, 
ymir default sbeU, or default command inicrpreier. The default 
shell is one of the parameters stored in the user database, and 
can lx different for each user. If you haven't changed any 
defaulLs, your commands will lx inierpretcb t^y /birVesh, also 
known as the C shelf The Terminal application just creates one 
or more windows and acTs as an interface betw^een iJiose 
windows, the keylnrard, the shell and you. At die shell prompt, 
you can type commands to be executed. 

You have the «)ption lo choose among many .shells. Most 
files under /bin and /usf/bin that end in sh are command 
inter|>aleni, or .shells. Notable exceptions are rsh and ssh, w^hich 
are meant to establish network connections to coniact shells in 
remote machines. 

For instance, try Is -I /bin. This command invokes the Is 
application, passing it -I and /bin ns arguments. Is lists files 
residing in your filesy.siem tree. Typically, the entire set of 
filesystems, the /iles\*slem tree, consists of a single iIFS+ hard 
disk volume and pos.sihly a CD or DVD volunie. If no argument 
is given* Is lists only ihe names of files in the current directory. 
In this first command, we liave specified the /bin directory, so 
Is will list the files in that direitoiy. The -I argument makes Is 
output lots of information alxmi the file.s, instead of ji^si their 
mimes. A typical output might Itwik like listing 3. 


Listing it typical output from the Is command. 


[local host: 

-1 

aiarceia% Is I 

/bfn 



total B208 
r X E X r X 

1 

root 

wheel 

Aog 19 

2001 

f 

r-xr-xr X 

1 

root 

wheel 

13880 Aub 19 

2001 

cat 

-r-xrxr-x 

1 

root 

whocfl 

13764 Aug 19 

2001 

chmod 

-r-xr Kt X 

1 

root 

wheel 

18B20 Aug 19 

2001 

cp 

r-xr'Str-x 

I 

root 

whc?pl 

318108 Aug 19 

2001 

cah 

t xr-xr-x 

1 

root 

wheeJ 

14544 Aug 19 

2001 

dale 

r xf xr X 

1 

root 

wheel 

26544 Aug 19 

2001 

dd 

r xr sr X 

1 

root 

operator 

1S50D Aug 19 

2001 

df 

-r-xt xr X 

1 

root 

wheel 

9/44 Aug 19 

2001 * 

donainnane 

r-xr xr x 

t 

roar 

wheel 

9184 Aug 19 

2001 

echo 

T-xr xr x 

1 

roat 

whep} 

60172 Aug 19 

2001 

er] 

-r-xrxr X 

I 

root 

wheel 

13728 Aug 19 

2001 

expr 

-t-xr xr-x 

1 

root 

wheel 

9396 Aug 19 

2001 

hDHt rvalue 

r xr-xr-x 

1 

root 

wheel 

13676 Aug 19 

2001 

kill 

r xE XI x 

L 

toot 

wheel 

13604 Aug 19 

2001 

In 

r xr xr X 

1 

root 

wheel 

26984 Aug 19 

2001 

iB 

'T-xr xt X 

1 

root 

wheel 

13832 Aug 19 

2001 

mkdir 

■rxe-xr-x 

1 

root 

wheel 

14392 Aug 19 

2001 

ni\r 

-rxext-x 

1 

root 

wheel 

9E704 Aug 19 

2001 

pax 

-r-st-xr-x 

1 

root 

wheel 

35S32 Aug 19 

2001 

pa 

’r'xr-xrx 

1 

root 

wheel 

9532 Aug 19 

2001 pwd 

r sr-xrx 

1 

root 

wheel 

24296 Aug 19 

2001 

rep 

r xr xr-x 

1 

root 

wheel 

14292 Aug 19 

2001 

rm 

*r-xr xr x 

1 

root 

wheel 

9356 Aug 19 

2001 

rntdir 

-r-xrxr X 

1 

root 

wheel 

465476 Aug 19 

2001 

sh 

r-xr-xr-x 

1 

root 

wheel 

9352 Aug 19 

7001 

flleep 

*r-xr-xrx 

1 

root 

wheel 

23896 Aug 19 

2001 

srty 

-r-xr-xr-x 

1 

root 

wheel 

9544 Aug 19 

2001 

sync 

r-xt'Xt-x 

2 

root 

wheel 

3I81D8 Aug 19 

2001 

tesb 
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-r-xr-xr-x 1 root wHcdI 136S6 Aug 19 2001 test 

-r-xrvxr-x 1 root wheel 46S4?& Aug 19 2001 zsh 

flocalhofJTi"'] »narcelo% 

we can see the file names at the end of eat'h line. 
Notice that very’ long lines, such as the one tor the domainname 
file in listing 3, get iiroken it up in two. This is tlone hy the 
rouitnes in the terminal window, and has nothing to do with the 
Is cominand. Is dix:s not tHUpitt a line break in the middle tif a 
logiail line, no matter how Icmg it is. 

The -I flag makes Is list, lx.\sides their name.s, also the 
type, access permissions, number of links, owner name, 
group name, si^e in bytes and creation date and lime of the 
files. In our next article, you will see the meaning tjf each of 
these bits of information. All of them have implications on 
your system's security. 

To Be CONTlNUliD.*. 

We liave seen some basics alxiut security in a tinix-like 
system, focusing mainly on users and groups, atid a more 
generic ctmeept introduced here, that of emmsers. Some of 
these concepts have obvioiis relations to security, which we vc 
covered here. So that wc w'ouldn'i stay only in the theoretical 
side, we've also covered a little bit alxiui shells and the 
coimiLind-linc environment. 

In f>ur next article, you will see an In-depth explanation of 
hie acce.ss permissions and how' iJicy relate to Unix users and 
groLt[)s. Then youll see some less than obvkais security 
implications of Hie ownership and permission bits. Utter articles 
in this series will cover praciical security measures yf>u could 
take to avoid common pitfalls when Lmplemeniing your 
applications under Mat: OS X. 
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QUICKTIME 
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'I'im Monroe 


The Sting 


Developing QuickTime Applications with 
''Stinger” 

iN'rBODircnoN 

In tlie previous QuickTime Toolkit article ("The Vision" in 
MacTech, March 2Q03), we look u look at developing 
QuickTime applications using Microsoft’s Visual Basic I noted 
then that Visual Basic provides no Iniill-tn suptiort for 
displaying or etiiting or creating QuickTime movies, hut that we 
can work with QuickTime movies using any one of several 
third-party ActiveX components. Apparently that anicle struck a 
nerve somewhere within Microsoft, for several days after the 
magazine hit the stands, I received a package — postmarked in 
Kedmond, Washington hut otherwise with no incitcarion of Lite 
sender — containing a single CD. The CD contains what 
ap[>ears to a pre release ven»i(m of a multimedia applicaiion 
framework develo[)ed by Microsoft. Hie product is named 
"Stinger" and sports a logo of a liee (which is eerily teminLsceni 
of die MSN butterfty). 

So far, I've spent only a couple of days working with 
Stinger, hut it^s clearly a software development environiiient 
of some importance for QuickTime developers. It alk>ws us 
to write applications that support Uie standard litany of 
Microsoft proprieUiry media and file formats (AVI, WIVrV7, 
ASF); Stinger also supports MFHG^ audio and videt) formats. 
This already is pretty surprising* as it represents an abrupt 
shift on Microsoft's behalf toward open standards for 
multimedia content. What’s even more .surprising is that we 
can use Stinger to develop applications that can create, open, 
and display QuickTime movies. And the li.si of (jperating 
systems that can run Stinger-developed applications is truly 
amazing; stinger can create multimedia applications that run 
on Windows, Mac OS, several flavors of Linux, Balm OS, and 
even MS-DOS itseif! For instance, Figure 1 shows the 
QuickTime sample movie displayed by an application 
running under Red Hat Linux; note the distinctive Red Hat 
"Bluecurve’" graphical interface. 



SampIe.niov * 

HEl 

□ 


j File Edit Jest Help 


] 



QuickTime 


figure i: A QuickTinie movie liiaying in Red IM Unujc 

In this article, we’re going to Uike a preliminary and 
imfortiinalely brief liK>k at Stinger. I should say in advance that 
the infonnaiion here is deriveti mainly from my own tinkering 
around with it (there was no documcntalion on the CD), and 
some of it is pure conjecture. Also, the name “Stinger" is cjuite 
likely a ccxle name — though judging from the prt>fes.sion;d 
finish lo the logo, the fin:d product name will probably have 
some apiary connection ("Visual Ikesic" perhaps?), 

MlicttosoFT \m QniciKTiMi* 

Perhaps the nio.st amazing thing alx>ut Stinger is that it exists 
at all I noted in the previous article that “Microsoft,.,dt>es not 
have a history of promoting QuickTime as a rmiilimcdia creation 
or deliveiy technology". That wa,s an understatement. In fact. 


Tun Monroe in a memlxT uf Uie QuickTime engineering team. You can contact him at inonroe@apple.com. The views expressei) here are not 
net e,ssarily shared by his employer. 
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Micrijsoft has a histoiy of trying to tleriiil ihc adoption of 
QuickTime, at least on Windows operating systems. Here is an 
excerpt from die court’s decision in the recent justice 
Department anti-lrust case against Microsoft: 

"S. 105. Beginning in ilic spring of 1997 and continuing 
into the summer of 1998, Microsoft tried to persuade 
Apple to stop producing a Window-s 95 version of its 
multimedia playback soflware. which presented 
developers of multimedia content with alternatives to 
Microsoft’s multimedia APIs. If Apple acceded to the 
proposal, Microsoft executives said, Microsoft would 
not enter the am boring business and would instead 
assist Apple in developing and selling tools for 
developers writing multimedia contenL,,.Apple would 
have been permitted, wathoii! hindrance, to market a 
media player that would mn on top of DirectX. 

But.Apple’s Quick] nne shell would not have 

exposed platform-level APIs lo developers. Microsoft 
execuiivcs acknowledged Co Apple their doubts that a 
firm could make a successful bu.siness om of marketing 
such a shell." (From the Courts Findings of Fact, Civil 
Action No. 98^1232.) 

At one meeting in April 1997, Apple engineer Peter I IcK-klie 
asked incredulously: “Are you asking us to kill playback? Are 
you asking us ID knife the baby?'' According to court lestimnny, 
a Microsoft official responded: 'A'es, we want you to knife the 
baby7 Ouch. (In.slder trivia faciokl: this exchange prompted a 
member of die QuickTime engineering team to print up lee- 
shirts bearing the slogan “Dt>n't Knife the Baby/) 

it gets wt>rse. .Some early versions of Micrtjsoft’s multiinedia 
playback applicratitin, the Windows Media Pla)H*r (also known 
affectionately and perhaps loo accunitely as WiMP), had a 
tendency to hijack the Qiiickl’inie movie MiME type (that Is, 
“video/quicktimG"). When a Windows user would navigate to a 
well site containing embedded Quicklime files (with the file 
extension mov), the movie files would be opened by WiMP, not 
by the QuickTime plug-in. la>r most media types, and 
particularly lor QuickTime VR movies, this would re.su!i in a le.ss 
than o[>rimal experience. 

Further, Internet Explorer version 6.0 ( which was hist .shipjX^d 
with Window's Xl^) and version 5,5 with Service Fac:k 2 applied 
broke brow'serd'ia.sed QuickTime movie playback altt>gether. That 
was l^:ause tho.se versions of Hi siop]>ed sup[)Orting NerScape- 
style plug-ins and because the QuickTime plug-in was 
implemented as a NetSc'ape-style plug-in. indeed, it was preci,sely 
to address this issue dial Apple developed (with MinwifFs 
assi.sLance, it must lie pointed out) the Apple Quicklime ActiveX 
control l\m we investigated in the previous arricie. 

1 could continue down this ixxid ad nausmm, but tlie fact is 
that 1 c:ome u> praise^ Miemsoft, not to bury it. After all, as I've 
suggested, Stinger repiesents a cx^mplete reversal of ihis ‘'knife the 
baby” stniteg)'. So, in quasi-VC4itergate style, let's follow tlie honey. 


Stin(;er Overview 

Tlie CD 1 received contains two folders, one labeled 
"Runtime Instalers" and the other labeled “DevStudio Installcrs^ 
The first folder contains what appear to be runtime environment 
installers for the latget platforms (more on thi.s later), I'he second 
folder contains only a single execumble file, Stngrlnstl.exe. After 
running the application, 1 launerhed Microsoft Visual C++ 
Developer Studio and was greeted with the Tip of the Day" 
shown in Figure 2. 



Figure 2: A Visual Studio Tip of the Day 

Dutiflilly, I .sc’lected tlie New menu item in tlie File menu. Sure 
enough, the list of available projects included "QuickTime 
Aj)plication" and '‘QuickTime Component", as shown in Figure 3, 
Clicking on "QuickTime Application" revealed tliat Stinger can 
genemte QuickTime-savvy a[>[ilications for seven different 
plaifonns: Windows, Mac OS 9, Mac OS X, Falm OS, Red Hat Linux, 
Mandrake Linux, and M!vDOS. I was. to put it mildly, intrigued. 



Figure 3: Neiv Project dialog box 

I named the new^ project “SringerSheir. Recall that our goal 
in this current .series of ariide.s i.s to replicate the functionality of 
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our existing appliotiun QTShdl. On Windows, QTShell 
provides support for opening multiple QuickTime movie files 
and displaying ihem in child windriws inside an enclosing fmine 
window. In other words, QTShcll on Windows uses the Multiple 
Doc'iiment Interface (MDl). It turns out that the default 
applic:aiinns tteated liy Stinger use the Single Dociinient 
Interlace (SDI): they open QuickTime movies in a window 
whose content area completely contains the movie and the 
movie controller l:)ar. ('I'he size of the movie widiin the content 
area can [yc adjusted, but for present purposes we don't need to 
do so.) So the only thing we need lo do io bring the default 
Windows application into line witli an SDI version o[ QTShell is 
add I he Test menu — where we add our application-specific 
items — and add some eode to handle those menu items. 

Adding Menu Items 

The programming model supported by Stinger is 
unexciting: it’s straight C ctxic that calls Windows APIs for basic 
appiictilion services (event handling, message prtK’essing, and so 
forth) and QuickTime APIs for inuliimedia services, listing 1 
shows the code that is called when the user selecls a movie in 
the file-opening dialog lx>x. 

Listing 1: Opening a QuickTime movie fil^_ 

OjK-nMovic 

void DpenHovIe CHWUD hwad. char ‘szFlleNamel 
[ 


shorr nPileRefKtim = &: 

FSSpec fssi 

NativePathManteToFSSpGC(szFileNaine, 6fS6, 0): 
SciGWorldt(CCrafFtrjGetUativeWIndowPorr(hwnd), HULL)j 
OpenMovieFilet&fss* StnFileRefNum. fsRdP^rm) r 
NewMovieFroiaPile(isHcFvie, nFlletfifSnm, Ntlt.L, NOLL, 
nevHovleActive. NULL]; 
CloseHovleFiletnFileRefNum): 


The only interesting departure from the standard Windows 
programining mtxlel that we've worked with throughout this 
series of articles concerns the S[XTilicaiion of the application's 
resources, 'llie default project contains a file StingarShellsc that 
defines the applicaLion's menus, icons, text strings, and dialog 
[x>x layouts. Tlris ,sc Ole is analogous m the .rc files weVe 
worketl witli previously^ hut supj>uns addiiitJnal resource 
compiler direc tives neces.sary to support deployment on dil'fereni 
platfunm, LisUtig 2 sliow.s how we c'an add in the I'esi menu but 
— for Pahi applications only — exclude lire Help menu. 


Ustiilg 2: Specifying the application^ memts and menu items 

SEingtTSJicU.M; 

lUR.MATNFRAME MENU PRELOAU DISCARBABLE 
BRGTN 
POFJF 
BliCJlN 

MENUITEM %New\tCtrltN". TO FTI.E NRW 

HENUITEW -40pen,,, , TD_Fn.E_OPEN 

HENUITEM '^&CloBG\i:Ctrl+W«, ItLPlLK^CLDSK 

HENIITTEM SEPARATOR 


RAGTIME*^ 

What the (*bleep*) is 
Business Publishing? 



iiii 


Vim 


m 




0 © a jgjutfcrinw a, 




apimus 








^onl rrv thts wMh your standard otTlce appCkation] 


Imagine - you write text, add a 
spreadsheet, add a graph, select and 
drag the data from the spreadsheet 
onto the graph to create it. Add all 
the pictures you need for your 
business report. All of this in a 
Desktop Publishing program? 

With RagTime you do word 
processing, spreadsheet, pictures, 
drawings and graphs in an easy to 
use layout environment using your 
word and excel files. 

That’s Business Pubiishing. 


By the way:RagTime is free for 
nQri'Comercfal use. Download at 
www.ragtime-ontme.com 



need more info? 

Comgmfix^ fnc. 

1765 Carnegie Avenue 
Clearwater, FL 13756 
Sales: 800,448.6277 

www.c om gra fuLcom 
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Sftvfghfr^ sewhd btffmg imremenfs 

Excellent rates on Intrastate, intralota/toll calls 
and International coiling with no term contract. 


Toll Free (800/888/877/866) service, 
same low per minute rote for incoming calls 


Detoiled billing directly from Ccpsule Communications, o Covista Company. 

Quolity electronic and telephone customr support. 
No monthly billing fee if you sign up for AUTOPAY billing 
option or if your bill is over $20.00 each month. 

hi«chargid ^fdiinymrhilis mh 


WWW* law€ostdialinff* €om 


MENUITEM ”5rSave^tCtrl+S^ 

MENU ITEM "Save 
HEHUITEM SEPAMTOR 
HENUT™ "E&xltVtCtrU-Q". 

END 

POPUP %Edit" 

BEGIN 

MENUITEM "&Urtdo\cCtcl+Z" , 

MENUITEM SEPARATOR 
MENUITEM ‘^Cu&tVtCtrl+XV 
MENIITTEK '^iCopy\tCtrl+C\ 

MENUTTEt! "&Faste\tCtrm\ 

MENUITEM ■♦C&l&arV 
MENUITEM SEPARATOR 

MENUITEM "Select &AH\tCtrl+AMD_EDlT_SELECTALL 
END 

POPUP "STest” 

BEGIN 

MENUITEM Controllei: Ear^tCtrl-f-l". 

ID_TEST_HrDE_CTRL 

MENUITEM "6HidG Speaker ButtDn\tCtrl+2". 

ID_TEST. HIDE_SPKR 


1D_F1LE_SAVE 

1D_I‘ILE_SAVEu_AS 

ID_APP„EXIT 


ID_EUIT_UMD0 

iU_EDlT_CUT 

ID_EEIT_CaPY 

ID^EDIT^PASTE 

ID_EDIT_CLEAR 


END 

iflf ITARGET^OS^PALM 
POPUP 
BEGIN 

MENUITEM "iiAbout StingerShell. .. " . ID_APP_AEOUT 
END 
#erjdir 
END 


Thu code required to handle our application-specific menu 
items is, once again, compleicly uncxciiing. HI leave it as an 
exercise for ihe inLcresLed reader to dredge up a past issue of 
MacTeeb to see how it works. 

Building and Running the Applications 

Now let's huilcl the applications. Select “Build StingerShell" 
ill the Build menu (or press (he F7 key). Once the build 
process completes, the Debug fedder will contain die usual 
colleciion of object files and other junk; it will also contain 
debug liuilds of StingerShell for the target platforms. If we 
launch the Windows application StingerShelLexe, well see the 
error window shown in Figure 4, 


This appficalion cannot run without the .HIVE runtirtie 
envffonrnenl Ptease install it now. 


OK 


Figure 4: A mnlime error message 

Tills is where the installers in die "Rumirnc Installers" folder 
come into play. Lei's run the installer WinHlvelnstl.exe. Once 
weVe done this, we can try launcliing StingerShelexe again. 
Tliis time, everything proceeds as expected. Tlie movie playback 
window is shown in Figure 5- 
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Fi^^ure 5: A QuickTime movie})laying under Wiriduu^ 


We can transfer the other compiled applications (and 
runlinie insiailers) to tlieir Xdrgei operating systems. The file 
StlngerShell.app is a Carlion application that can run on Mac 
OS 9 or Mac OS X. Figure 6 shows StingerShell running 
under Mac OS X, 


PrimeBase 4.2 
Replication Server 



Check out the fully programmable 

Replication Server 


• Bidirectional Updates supported 

• Update 3rd-party DBMS 

• Send Emails 

• Post/get Data to/from Websites 


www.primebase.com 



dev 


eVoper KeV® 

avaWa'^te 

fy\ cba’^9® 


tree 



0 e Sample.mov 



QuickTime 
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figure 6 : A QuickTime movie piuying imdcTMac OS X 


The file StingerShelLrhl is the executable for Red Hat Linux (see 
Figure 1 again), 'fhe Me StingerShelLml is the executable for 
Miindrake Linux (Figure 7). 


ALL PrimeBase Server Software 

• SQL Database Server 

• Application Server 

• Replication Server 

• Open Server 

AVAILABLE ON THE MOST POPULAR PLATFORMS 

• Completely cross-platform 

• Full-text searching and indexing 

• Mac OS & OS X 

• Linux 

• Solaris 

• IBMAIX 

• all Windows platforms 


PrimeBase 


SNAP Innovation GmbH 
Altonaer PoststraBe 9a 
D-22767 Hamburg / Germany 
www.primebase.com 
e-mail; info@primebase.com 
Fon: ++49 (40) 389 044-0 
Fax: ++49 (40) 389 044-44 
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figure 7: A QuickTime moiiepUiying under Maudrak* Liutvc 



Figure 9 ' A QuickTinw movie playing under PalmOS 


Af^parenlly there \s already a PalrnOfS applioiton widi die 
trademarked name StingerShell, so IVe rtfoanied the Palm 
applkation QTShelLprc, When we download the executable to a 
Palm device, we'll see it in die list of availalile programs, as 

shown in Figure 8 



^ # 

Cteck Dote Sook Oroffitj 

Q> © 


KotSync Med MeiVKf Pod 

^ # Q 

l4ot«rcd Prefs 


figure H: Q'fShcll in the list of Palm programs 
Figure 9 shows Ql^hel! running on die Palm device. 


CONCLlfSlON 

Tills is all very ctx>l, hut how does il work? Apple provides 
QuickTime ninlime support only for Macintosh and Windows 
oixaating systems. How can we run Quicklime applications on 
Linux and Palm systems as well? This is where I’m reduced to 
fiure speculatiun. As weVe seen, our compiled applications 
would not run without die jirior installation of the soxalled 
Mil VP" runiimc enviromneni. Pm gues.sing ihat lliis is some sort 
of inultiiiiedia extension to Micro-sofPs .NET environment, 
A]>i>arently Microsoft has shoehomed the QuickTime libraries 
into the platform-sjxvtfic .1IIVE interpreters and also provided 
sr>me sort of emiiiation layer for ihose filatfoniis that do not 
natively support QuickTime, Or sti Pm guessing, if 1 had more 
time and a gcxxl delmggen I axild probably figure out more of 
w^hai’s happening under the hoexL 

No mailer how if works, iPs clear that indeed it dt>es work. 
It’s sad to realize that Microsoft has Ixaien Apple ut the punch 
in supporting QuickTime movie playback on Palm devices and 
on Linux platforms. 'Phe performance is not good {1 was able to 
achieve a playback rale of only about frames per second on 
a Palm device, and only about fps under the Linux systems), 
but the API coverage appears to lx‘ fairly complete. Sigh. 

Credits .vnd Retraction-s 

Special thanks are due to an unknown source within 
MicTosoft for providing a pRf-release copy of Stinger. 

You may have noticed lliai Quicklime I'oolkit articles sport 
Titles ixirrowed from movies (appro(>riate for a series on 
QuickTime, eh?). Perhaps a Ixtier tide for tlie present artic^le 
would liave been the 1969 Jack Lemmon and Githerine Deneuve 
comedy, “Tlie At>ril Fools". 
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... now, for a 
limited time, 
when you buy 
MYOB AccountEdge 3, 
we'll give you Mac OS X 
absolutely FREE. 


MacOSX 


Accour i 
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Account Ed( ^ 


AccountEdge 


Evolving with the Mac since 1989 

Small Business Management and Accounting 


www.myob.com/us 
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REVIEW 


By Rich Moriri 

Books on Cocoa Programming 


The field is filling in... 


I've Spent ihe Iasi few months learning my way around 
QK'oa programming, using a combination of Objecfive-C and 
Perl. Pm not anything like a wizard yet, but Vm getting t)y and 
even starting to feel a bit c:onfidenl- I have received lots of 
suppon from folks on assorted mailing lists, but these hooks got 
heavy usage first. “Read the Fine Mamiar, and all 

Wliether yoiPre just starting up the Cocoa learning curve or 
well along the way, I’d suggest that you consider getting some 
of these lxx)ks: 

Building Cocoa Applications: A Siep-by-Step Guide 
Sirnson Garfinkel Michael K. Mahoney 
O’Reilly, 2002; ISBN 0-596-00235-1 
622 pp.; $44.99 

Cocoa Pfogramining 

Scott Anguish, Hrik M. Buck, Donald A. Yacktman 
SAMS, 2{K)2; ISBN 0-672-32230-7 
1245 pp.; $59.99 

Ccx’oa Programming for I>uniitues 
Erick Tejkowski 

Wiley, 2003; ISBN 07645-2613-8 
36(> pp.; $24.99 

Cocoa Program tiling for Mat: OS X 
Aartin Hillegass 

Addison-Wesley, 2002; ISBN 0-201-726834 
383 pp.; $44.9^; 

Cocoa Recipes for Mac OS X; The Vermont Recj|x?s 
Bill Cheeseman 

Peachpit Press, 2003; ISBN Q-20h8780M 
752 pp.; $4199 

Learning Cotx:>a with ObjectIve-C ediiicm) 

James Duncan Davidson Si. Apple 
O'Reilly, 2002; ISBN 0-596^00301-3 
360 pp.; $34.95 


Executive Summary 

If you're just starring out, Fd recommend "Cocoa 
Programming for Dtunmies''. Really. It’s economical, a fast read, 
and will give you a quick and t)ainless introduction to the main 
topics you'll be studying later. 

Next, you 11 want to skim the two O’Reilly l>ooks (“Learning 
Ctx’m with Objective-C" and ‘'Building Cocoa Appliaitions"). 
Yt>u1l also want to keep them close at hand for reference. If you 
already have some O'Reilly Ixxiks, you 11 know what to expect 
from these: dean, siilid presentation, coasistent organiziition, 
g(K)d prtxJuclion values, etc.. 

With this background, you 11 be ready to tackle any of the 
last three volumes. I found each of these to contained things that 
llu‘ others did nt)t, but 'Txx’oa Programming" was by far the most 
detailed and definitive of the Itn, In faa, if you can only afford 
to liuy one Cocoa prognimining book, “Cocoa Programming" 
would lx* the best use of your money. 

Cocoa Programming for Dummies 

'Ihe goals ami appniach of this Ixxjk are alxiut as far from 
“Ctxixi Pnjgmiruiiing’' as it is [Xjssil.’jle to be. It isn’t partiaibirly 
dclaiicxl, Icl altine definitive, and scTeenshots fill many ol' the pages. 
Nonetheless, it is a worthwhile Ixxjk. In hiti, it's the liest “jump 
start" Ixxjk fve seen, j^mviding a painless way for “newi>ies” to 
]>ick uj) the key cTjacepts of Qkou progntmming. Just lx* ready to 
buy some more txxjks before trying to shift intt) second :-). 

Although the Ixiok itself contains relatively little code, the 
supporting web site (www.dummtes.eom/extras) has cjuite a bit. In 
fact, it provides a 16 MB ".sea" archive witli st:>urce code, pre- 
butlt pac:kages, and more. Tlie exami>tes are all simple, but that’s 
c|uite ai>propriate to the introduciojy nature of the bfx>k. 

Learning CtK:oA wirn Objecove-C 

Altltough I like this lx>ok, I was surprised by the number of 
typos and other small errors 1 encountered wliile reading it 1 
shouldnl l>e able to find dozens of glitches in any O'Reilly book; 
given that this is a second edition, I should be hard-pressed to 
find any at ail. 

Nonetheless, it's a grjod inlnxliittory' Ixjok. It covers the 
basics of Ccxxra, Objcciive-C, OOP, etc,. It won't take yon very far 
into C<K.xra progmmining, but it's a fine iead-m and wall also be 
liandy to keep around as a reference. Like “CxKxxt Programming 
for Mac OS X", il contains a wealtfi of useful diagrams, which 
fret[uently fielp to clarify the topic under discussion. 
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Bltildumg Cik:oa Appucations 

Although I found iliis IxKjk u.scful, l\ is not my idea of a 
"^Siep-hy-Step Guide"". After short introductions to Atjua and 
Apple's dcvelopmeni tools (--6t) pages each), it junips headlong 
into three large “AppliLaiions": 

* ''Oilcubitor: Building a Simple Application (152 pp.) 

* “MathPaper: A Mulriple-Document, Mukiprocess 
Application CI5^ pp.) 

* "GraphPaper: A Multithreaded, Mouse-Tracking Application 
(150 pp,) 

Each application is used as a vehicle for explaining certain 
aspects of CJocoa prograinining. For instance, the Calculator app 
is used to introduce ‘'Nib.s and Icons”, “Delegation and Resi;^ing", 
“Events and Re,sponders", and “Darwin and the Window Server", 

Cocoa Progicamming for M-ac OS X 

Tins fxKik “splits the difference"' l:)emeen “Cocoa 
Pn)gramining" and “Cocoa Programming for Diuiimles”, It moves a 
lof faster than one and a lot slower tlian ilie other. It h;is a nic^ 
sprinkling of screenshots, m;iny useful diagntms, and a fair amount 
of detail, fm particularly happy with the coverage of design 
techniques, programming pitfalls, and other “imiidental"" i.ssu^. 

Tlie writing style is quite intbnml and relaxed, but die cx>nient 
is very solid. If you ean'l afford to attend a course at “Big Nerd 
lianch” (tile author's training facility), you may find dial this Ixxik 
provides a simikir set of tnibniution, delivered in a similar numner 

Cocoa Rfcifes for Mac OS X 
'Phis book is based on the ' Vennoni Recipes” application, 
a ‘"sampler” which shows off most of die siriipler Cocoa widgets 
Ce,g,, buttons, drawers, sliders, tabs, and text items), complete 
with error-checking ccxle and odier niceties. , Liil> views, and 
drawers). It walks the reader, in painstaking detail, dirough the 
steps needed to repnxJiK e and enhance the appIicatioiT 

'fhe web site (wvw.stepwise.com/A1tidesA/0rmontRecipes) 
contains tx>th the app and the project files that were used to 


buiki if. If you like to work your way through someone else"s 
exampies, iliis site (and the accompanying book) slK)uld Ix! very 
worthwhile. Alternatively, llic app provides a fast way to play 
around with a lot of Cbc'oa widgets. 

Becrause my own approach involves blundering my way 
through my own projects, I havener used diis lx>ok (or any of 
these books, really) as the audiors intended. Nonetheless, I was 
able to use it frtim time to time as a way to cbmfy obscure points 
of Cocoa programming and tool use. 

Cocoa Programming 

As noted alx>ve, this is a very detailed and definitive volume. 
In fact, 1 found it rather intimidating at first: lot.s of text, a lair aniount 
of axle, and only a .small numlx:r of sac'enshots and tables. With 
lime, liowever, I realised that tills book was answering my 
pR^gKUiiming questions Ix^ller ilian any of the other volumes. 

1 like this book so well, in fact, that I'd like to see it 
exjianded into two volumes, The first could Ik‘ augmented 
with more imroduciory information (e.g., on Apple’s 
developer tools, the Cocoa programming models etc.) The 
second c'oiiid concentrate on some of the rtifirc esoteric 
aspects of the Apple Frameworks, 

Coming AiTRAcnoNS 

Other Ctxoa pnogramming books are on the way. Some of 
these will fill in holes left by the current crop; otliers will attempt 
U) sttpplant existing books. None of die current \xx>ks cover 
Cocoa firograrnming in languages other than Objectivc^C (e.g., 
AppleScript, java, Perl, Pytlion, Ruby, and Visual Basic); I know 
of at least one such tx)ok (on Perl) diat is in development. 

I wixild really like to see a detailed reference for die entire 
range of Apple's develojKT uk) 1 s. I have spent far too much time 
trying to find information on Interface Builder and Project 
Builder; Fd love to have a single book tliat covers diem, as well 
as some of die obscure tools in “/Developer/Tools"" and 
“/Developer/Applications"", in painsmking deiail. 



Now serving Cocoa 
just the way you want it. 

Training for Mac OS X doesn’t have to be the same old flavor. 
Reserve your seat in a class at our scenic lodge location, 
or have experts come to you for Extreme Mentoring. 
Two weeks of on*site instruction and collaboration, 
customized to the requirements of your project. 
L Book now for 2003. See why we're different. 


Bio 

nerD 

V J rancH 

Inrenjtve Classes for Programmers 
www.blgnerdranch.com 
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MAC OS X 


By John C. Welch 

Jaguar for Administrators 


Where does Jaguar stand on the network? 


Jaguar trom the IT khnt of view 

Writing a review of an operating system from tlie network 
atlininistrator's point of view is always a l)it (xld. Espeeially when 
that operating system is Mac OS X, For one thing, most of lire 
feaiKies in Mac OS X that other reviews center on don’t really 
matter here. Aqua, hnxies, and other user gadgets aren't that 
important. Rather, the deep esoteric parts of the OS get a rare 
momeni in the limeligln. It also Jtieans that the review is far more 
concerned with how Mac OS X plays with other environments 
than you would nonnally see. Now, this is mi going to Ix" a 
feature by fKiture review, but rather an overview of Mac OS X 
and Mac OS X Server from a nemork administrator \nnni of 
view. With that in mind, onward and downward. 

Mac OS X is an odd Ixast of an 0 ]>erating system for 
netwt>rk administnitors. especially those list'd to Iradiiitmal Unix 
operating systems. ’I'herc are a numlx-r of dilTerences that will 
trip you up. Configuring Apacfic, for one. Other things like CGI 
access and SSL have ratlier unique configuration Lssues. Keep in 
mind that just because you know' USD anti/or other llavors of 
Unix inside and oui doesn’i mean you have the same level of 
knowledge in Mac OS X. In oilier words, don't assume. 

Once Mac OS X is set up, it s a great client, hut getting tirere 
is painful. If you are not running Mac OS X Server, then creating 
things like groups and aliases is far more onerous a task than it 
otiglu to lie. llie only way is to either usi' Nclinfo Manager, 
which is still not reliable enough to lie completely trustworthy, 
or use command line utilities, such as niulil, and aid. If you w^ant 
to import a group of users, the command line utilities are the 
only reliable way to do this without Mac OS X Server. 

.. is far harder tmihoiif Mav OS X SenHjr"' Is a recun ing 
theme when adniinisiering Mac OS X. 'lire r)nly way Apple 
supjKirts running Mac OS X networks is with Mac OS X Sender, 
and as a result, trying to run Mac OS X withoiti Mac OS X Server, 
while certainly doable, is a lot more tediou.s than it should be. 


Open Directorv 

One of the big reasons for the tediousness in managing Mac 
OS X is Netinfo. While it was groundbreaking w'hen it wa.s 
introduced with NeXTSlTP, it does pfxirly compared to otlier 
direaory^ systems like LDAP, Aaive Dtrecu>ty, and NDS. Ifs 
pixirly dtx'umented, dtxrsn’l integrate will with other tools, and 
is for all practical [luqioses a single platform system. Nclinfo 
Manager is, compared to any other directory management 
application, painful (a direciuiy management tool that doesn't 
have online help is a [)ad thing). While Netinfo is certainly not 
as fragile or obtuse as the Windows Registry, it s not much lietteL 
Tile tools for dealing with Neiinfcj are (if [xissible) even worse 
than those for the Windows Regislrv^ 

Even on Mac 0$ X Server, there is no gtxxl icx)l for managing 
the dia^ctoiy as a thing. You cxin manage asjxcLs d the directory, like 
users, groups, machines, printing, etc., but those are things you use 
with the directory. The only tcxjl availaliie to manage the directory 
itself Is Netinfo Manager. Oumfiaa^l to other dia-ctory tools, Netinfo 
Manager Is kxrsy at managing Neiinfo Diralories and doniaias. If 
you are trying ro implement and manage LDAP domaias under Mac' 
OS X Server, it’s even woi'se. Netinfb was simply neglected for too 
long, and is itxi isolated to lx* as centnil as it is lo an ojXTating system 
Hying to move into the future. Ajijile needs to put Netinfo in the 
same coflin as Mac OS 9, and the scx)ner the IxUer. They neexi to 
gel a reiil directory^ nian[igemeni kxil w4iile they’re at it, tix>. 

Since w^e're on ihe topic of diiexlories and direcaory 
iniegnition, we need to touch on wliat Open Direciory aciually ls 
and Ls not. First oif. it s not a specific directory tyjx% altliough it’s 
ftxused on LDAP. Open Directorv' is moK* of an architecture that 
allows different direcLtjry iy[X*s lo plug into the Open Directory 
Hinicturc. Mac OS X ships with a numlxr of Open Directory 
plugins, including LDAPv2, LDAPv3 (new in jaguar), and Netinfo. 
Note ihat the plugins don't have to lie 'clirectories'. Rendezvous, 
Af>plc7ulk. SLP, and SMB are also pan of ihe Opt.'n Dimctory 
ct mtainer If you think of Opc^n l lirmory as a container for pouring 
difilerent ways to manage Mac OS X on a network, then it gets less 
confusing. Tliird parlies can also write pliigias for the Ojxm 
Diieclory architecture. 'Iliursliy Systems DAVE 4 Is one example. 


John Welch <jweicliSliTiii.edu> is an IT amsultant for MIT C^eniral IS, and the CJiief Know-U-All for TaekyShiri. He hxs o\xt fifteen ye*irs of exjierience 
at making computers w'ork, John specializes in figuring out ways in which to make the Mac do wlial mjlxxly thinks it can, sliowing that the Mac is 
tlie suixirior adinini.siraiive platform, and teaching oiliers liow lo use ir in irueresting, if sf>metimes frightening ways. He also does things that don't 
involve conipuiertry on tKOsiori, or at lea.si that's the mmcir. 
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Kil^ ai&o available at: 
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...this really is easy; 

WIBU-KEY Software Protection 


■ Software goes online 

Electronic Software Distribution - 
safely protected by WIBU-KEY. 


■ License Management 

You can easily and flexibly create and 
manage network licenses. 


■ Pay-Per-Use 

Usage dependent accounting of 
your software. 


■ Mac OS 9 & X 

WIBU-KEY supports Mac OS, Windows 
and heterogeneous networks. 


Kiff; thri WffifJ-rCfBY PmfficTfon fCrf: 
fe(= ancT dadda for yoi/rirfiffr 
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Figure 1: Directof}^ Access shoiinng Opeu IHrecior}* plugim 

As we see in the illuslralinn atxjvc% the settings for various 
Open Directory plugins are configured via the Dirctii^ry Access 
application, found in /Applications/UiiliLies. This f>rings me to 
one of the biggest complaints 1 have with Mac OS X and Mac OS 
X Server as a network administrator, and that is tkx:umentatit>n. 
Wliile I can easily download gigabytes of information on every 
development API on the platform, here is the sum total of 
Directory Acces^s' help tm setting up your system to work with 
Active Directory: 


if yem w£ini a Muc OS' A” computer to gel admitmtrative data 
from an Active Directory^ sertJer, the data must exiKi on the Active 
Director}^ sender in the format required hy Mac OS X. You may 
need to add, modify, or reorganize data on the Actiw Directory^ 
senjer. You must mah^ the necessary modijicatiom hy using tools 
on the Aaive Directory sender 

We all understand that Apple has limited resources 
compared to some, but for Mac adminlstmtors, gening their 
Windows counterparts to w^ork witli them is liard enough; foaing 
them to teli a Window,s administrator ilrat the only way to get the 
Macs to integrate properly requires schema mcxlifitinions, or 
ihird party products on the Active Directory sc‘rver is just not 
going to fly. In the networking world, Apple is the little guy. *11iey 
need to m:tke the exim efTori. The s;ime applies to other directory 
.sclietnes. Wliile tlie support for more ‘standanl' LDAP schemes, 
such as 0|>€nLDAP and Sun's Directory Server, is Ixmer, Apple 
still needs to make this as simple as selecting the Direaory Server 
type, clicking ‘’Add my machine to this dcmiain’^ and entering an 
adminisiralive password. 

"Iliis is not to .say i hat Open Directory is worthless. Quite 
the contrary. By including proper supixirt for things like 
LDAPv3, LDAPv3 over SSL, and suppon for using Berkeley 
configumtion files acros.s the network, Apple has made Mac 
OS X s directory .services support work on the level that we 
need it Uc The LDAPv3 support in Open Directory is well 
thought out, and answers most, if not all tif ihc problems writh 
Ll>AP support in Mac OS X prior to Jaguar. Things like using 



$59.95 gets 
vonitiere!! 


Got VideoP 

Publish it with CustomFlixi 


You want this 


You've got this 


CustomFlix DVD 

Publishino » 

• Burn your DVD title onto the DVD-R media 
■ Send it to us with the prepaid mailer 
" Set up ycHtr e^re with your ewn text & art 
" Promote your titie & cash your prviit checksJ 


The CustomFlix DVD Publishing Kit 
makes it easy to sell your DVD online. 
Get yours and in no time you can direct 
customers to your own customized e* 
store, complete with streaming trailer. 
When tfiey order, we do all the work, 
including e-commerce, on-demand 
duplication, printing, and shipping,., all 
you do is cash your profit check? 


Pay for yow tools 
with your videol 


Once you buy your DVD Publishing 
Kit, you set the price of your titles. 
CustomFlix keeps the first $9.95 + 
5% of each sale; you gel the rest If 
you sell your program for $24,95. 
you’ll make $13.75 every time 
someone buys a copy. That means: 

4 sales pays for the Publishing Kit 
20 sales pays for a 4x DVD-R drive 
70 sales pays for Final Cut Pro 
500 sales Is $6,875 in your pocket? 

Get your DVD Publishing Krt 
today for ONLY$59.95 


CustomFli;^, 


Visit WWW. CustomHix.com 
or Gaii {8881232-0439 
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SSL U> entry pi the d;ita flow, using a specifir diMingiiished 
name and password when (xinnectmg to the LDAP server, and 
being able to set custoni niappings (even writing them to the 
server from the client if need be) all show the hartl wc^rk that 
Apple has put into the plumbing of Open Directory* The 
impfementation is still ntH ihere yet. A great deal of the 
benefits of LDAl^ are lost as sixjn as they hit Netlnfo^ and its 
rather poor implementation. 

There's no AppleScript support in Directoiy^ Access, or 
indeed, any of the Mac OS X Server tools from Apple, so you 
can't automate any of this setup. If you want to set up a 
hundred new Macs, there's a lot more manual work than 
there ought Co be. Being al>le to automate client setup is a 
critical need for any administrator, and for Mac administrators 
that means AppleScript. Learning shell should not be 
necessary to run a Mac* 

Unix tools 

Since Mac OS X and Mac OS X Server are based on 
FreeBSD, bow do they stack up as Unix opemting systems? Tlie 
answer is “really good" and “really annoying". For the most 
part, an extx.‘rienccd Unix administrator will lie quite at tioinc 
with Mac OS X. Tliey will find themselves stumbling a bit as they 
l)tl tlifferenc'es, Itfwever. User home direcLories are not where 
they ‘should’ lx.\ Tfie default file system Isn't UTS. Tlierc aR‘ no 
Tape drivers, so you can't just use tar, gnutar, dump, etc., to do 
<|uick and dirty backups. l!>uiiip would liave major issue with 
HFS+ anyway. 

There's also no command line Uxilset that makes doing 
things via SSI I a bit easier titan running command after 
command. One of the Ix^st examples of this Ls SMIT, found on 
IBM's AIX. It runs in Ixah XII mode, and command line nuxie. 
SMIl* is really nothing more than an application that takes input, 
and ases that input to nm various adminLstmlive related .shell 
commands, Bui even over the command line, it gives you a l>asic 
menu driven method for getting work done* Thanks to the 
command line mode, SMH’ w'orks quite well over dialup, 
something llmt Apple's G11 tcx^ls do not do well at iill. As Chuck 
Goolsbee, ListMoin for the Mac-Mgrs list says, “SMll' Kcxks!", 

Apple has done a much better job of making sure there 
are command line versions of the GUI utilities in Jaguar, 
especially for things like remote setup, remote network 
setup, software update, remote installations, and others. This 
was a critical issue for many administrators, as there was 
simply no way to ttiigraie to Mac OS X if the only way to do 
things was via a GUI. fOf course, prior to Jaguar, you 
couldn't use Mac OS X Server to manage Mae OS X boxes, so 
that was a problem ifiat Jaguar alleviated.) We all understand 
that to most users, the command line is anathema,. Fveii 
some Mac administrators have opined that Apple shouldn't 
have released Mac OS X without a GUI equivalent for ever>' 
single command line utility. This is ju.st ridtcnlous. While the 
commanti line should never be a reejuirement for users, 
administrators fall under different rules. For administrators, 


SOFTWARE 

LOCALIZATION 

MAOE 
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Localize Classic, Carbon Cocoa and Palm OS apps 
Leverage existing translations 
Autohate with AppleScript* 

Import ^export translation memories 
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[he command line us a force multiplier that they have needed 
for c|uite some time. 

Wliiie Mac OS X currently dtxjsn’i ship with an Xll 
implementatioji, the reccni release of the Xll preview at 
MacwoHd Expo shows that Apple is takin^J this envirtmment 
scrit)asly. No, XI1 is not Aqua, nor is it as easy to use as Aqua. 
It is, however, a sfantlard GUI enviromnent available for every 
Unix in use, and tlianks to things like GNOME, and KDE, Xll Ls 
getting dose to iDeing as easy to use as Atjua. In addition, there 
are a number of critical applieaiions like MatLib and IDL that will 
probably never show up as full Aqua applications, [)ut rather its 
Xll applications. Other Unix appliattions, such as Ojx^n Office, 
aa" likely to show up first as XI1 applications, with Aqua versions 
coming later. With that in mind, it is far more intelligent for Apple 
(o have an Xll implementation that is ersy to use, configure, and 
integrates properly with elements like Aqua. We would like to 
see Apple take this even fuither, and integrate XI1 into Mac OS 
X to the extent dial there is no difference, to the tmer, lx.‘tween 
an Xll application and a anie* Mac OS X application. If Apple 
can get Xll to a 'df>uble click and gc}’ state, then they will have 
answered a huge coini)lainr from the Unix workl. 

Servf.r Administration Tck^ls 

'lliis area of OS X lias prol?abiy seen more iniprovemenl 
under Jaguar than almost any other area of die OS. With Jaguar 
Server, Apple finally shipped a server that had the tools to 
properly administer Mac OS X. While there has lieen a great cieal 
of public ct>minent alx>ut Quark slowing Mac OS X adoption, 
the lack of tools to nin Mac OS X neiwtjrks prior to Jaguar SenxT 
hurt that adoption mre in places with multiple Macs as much, if 
not more dian any one application. 

Again, while Apple provides you with solid GUI tools to run 
your server and ytiur neiw^ork, liiey are marred by the same 
stumbling hkicks that crop Lip all over Mac OS X. Kor example, 
you can use Kerberos to authenticate clients Lxinneciiiig via FTP 
and AEP, but not SMU or NFS. Tliere Ls one dick support for 
Apple'Falk over SSH, but nodiing else, even though KIT and NFS 
l>oih Ixrnefit gready from adLlitional security. Applets CUl ttx)ls 
for Windows file sliaring are so limited that you should 
essentially ignore diem, and use SWAT, an open source, web 
ixised Saml>a configtiration Kxd insteatl. Even witli SWAT, 
Apple's iiKxlifications to Samba are still hit and a miss. They hit 
by iniegniting Samira and 0]>en Directoiy, but miss by making 
j| painful, and in some cases impossible, to use the [iiore 
inieresling features of Samba, like its ability \o lie a Window^s NT 
4 Primary Domain Qmiroller. Once again, it's that lust 20% of the 
effort that makes a product great, instead of merely adequate. 

Apple's provided mail server, while much improved over 
earlier versions, Is still frustrating when you compare it to other 
prtxluct.s such a.s Communigate Pro. There are no easy w^ays to 
enable functions like IMA? or PO? over SSI in the IJh On the 
other hand, enabling Kerberos authcniicadon is a single 
checkbox away. Of course, setting up Mac OS X Server as a 
KDC, heck setting up Kerberos servers in general is not easy. 


Apple’s implementation of Apache Ls the same mix of ease 
of setup, and frustration at the hancis of iKki implementations. 
Selling up CGI access for user sites on a Mat OS X Server !x>x 
is more work than it should be, and ctaiipletely different than 
almost every' other Unix platldnn. But then again, you find that 
selling up SSL is as easy as on be, although SSI access is a leas 
comiiion need than CGI access. You can enalile WebDAV for the 
server as a whole, but you have to then enable it individually for 
each site. It is n<>t clear that you have to do so, an issue that bites 
Unix administrattiis a lot, especially if Mac OS X Server is the 
'ne%v' OS for them. 

fhis occurs across the board for many of Apple’s lools. 
Firewall setup is easy, yet Apple just throws iPs hands up at 
DNS, only allowing you to turn DNS on and off From the GLJI 
tools. 1Tie rest has to i>e dune via coiifig ftle.s and the 
command line. Considering that Apple's server tools will not 
work, or work very badly if DNS isn’t set up correctly, this 
service should have a far mtire comprehensive set of tools. 
Certainly more llian just an on/off switch. Apple's server 
monitoring and status tools give you an excellent display of 
hardware and servic'e conditions, but the only effective tools 
to kill a mnaway process are ssh, top, and kill from die 
command line if you aren t at the system console. 

CONCXUSION 

Mac OS X and Mac OS X Server are si ill in fairly early 
slagc.s of development, and ihal needs be taken into 
consideration when reading the negative comments above. On 
the wliole. they are lx>ih excellem umiIs for admintsiraiors. 
However, the continuous stream of .stumbling blocks throwm in 
an administrators patli makes that excellence hard to see at 
limes. What to be done is a matter of ffx'using. Apple 

neetis lo start making each minor update a chance to focus on 
one set of problems, fix ihem, and move on to the next. Each 
update is still trying lo do too much at once. As a resiili, you 
end up with minor improvements and glaring omissions (like 
tile XServe drive bay door problem, slill not fixed as of Mac (")S 
X 10.2.3). Administrators would Ixf Ixrtter served by an update 
ihai only deals with Apache issues, nr Samba issues than by 
one that fixes one or two issues each from a half dozen 
categories. 'Hie adminisiraiion tools need lo be taken lo lhat 
next step as well. Wliidows file sharing and DNS administration 
tools lack of functionality mu.st be fixed and soon. The lack of 
a good directory adminisiration tool needs to be remedied as 
close to yesterday as jnissihle. Finally, Net I nib needs to go 
away. It was a great prcKluct in its day, but the fact lhat it was 
neglected For so long, and the practical limitations of Netlnft) 
on Mac OS X are two ymjblems lhat are not going away, and 
are not wtjrth fixing, when you have LDAP being used 
globally, and continunity improved. 

So, from the administrators viewpoint, Mac OS X i.s about 

of ihe way to being a truly first class client and server 
oticrating system. Once that work is done, tlien Mac OS X will 
truly be the .superior OS lhat it strives to l>e. 
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stay In Control Wherever You Go. 



There 


Now, both of these indispensable toots 
are updated to take full advantage of the 
world's most advanced operating system. 


For more than a decade. Timbuktu Pro and netOctopus 
have been the leading remote control, file transfer and 
systems administration applications for the Mac OS. 


Mac OS X Ready 


lid 




Windows XP Ready 


Timbuktu Pro 

Whether you're at home or at work, Timbuktu Pro allows you to operate distant 
computers as if you were sitting in front of them, transfer files or folders quickly 
and easily, and communicate by instant message, text chat, or voice intercom, 
http: / / www.tim bu ktu pro.com 


netOctopus 

Intuitive and powerful, netOctopus can manage a network of ten or 10,000 
computers. Inventory computers, software and devices on your network; distribute 
software; configure remote computers; and create custom reports on the fly. 
http:/ / www.netoctopus.com 


Learn more, try it, or buy it online. Call us at 1-800-485-5741. 



timbuktu® • netOctopus' 
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MAC OS X 
MIGRATION 


By Cabel Sasser 

Redesigning Right 


How we adapted the Transmit interface 
for Mac OS X 


1'hev’ij. N<>tice..* Oh, Tidy’ll Nobci 
M'Av users are crazy. Not clucking-like-a-chicken'in-ihe- 
refcrence-siatks-oMie-piiblic-iibrary crazy, bin ihe g<xx! kind of 
crazy - ihe kind ihai can inspire an intense passion, love, 
cominiimeni and evangelical fervor for something as dry as a 
computing platform. And as Mac users, we iove our interface in 
an almost unnatural way - your application could print diamonds 
and candy from an ordinary hubblcitt while whistling Dixie (and 
I'd like a copy, please), but if your app isn't easy, pretty, and 
thoroughly Macdikc, it will be dismissed. Wiili the arrival of Mac 
OS X, the importance of interface has become even more critica! 
- Apple has set the l>ar for cjuality UI design even higher, 

Thus, if your Mac OS X application at all kx)ks noi rfuUv 
right, yoifre in trouble. Maybe your default l>mtons are aligned 
left, or your status text is still Geneva 9, or your Preferences are 
only acces.sil)le via the "'Edit” menu, or the background of your 
window is filled with a scaled photograph of a iK^miiful 
Icelandic mountain goat. No matter what the offense, when a 
Mac apjjiicaiion dtxrsn't follow the Apple Htiman Interface 
Guidelines to the letter, people notice, even if they have no ide:i 
that there is such as a thing as "Interface Guidelines”. 

When we L(K>k our first stab at a Mac OS X port of our FfP 
client Transmit (the Carfxjn-based 1.7b2), we pretty moch 
brought the interface over identically - the gtxxl oP ''Bare 
Minimum" port. We updated the font to Lucida Grande, replaced 
scjrne old folder icons, spaced tilings out a little, and atlded a new 
128 X 128 icon, but tliat was alxim it. After a few moiulis of 
getting under Mac OS X's skin, it w^ts clear to us that 17b2 wasn't 
even rc^iTHJteiy cmxigh. Mac OS X threw almost everything we 
knew alxiut Macintosh interface design out the window, but 
things had improved - now, when we IxxHed in Mac OS 9 things 
fell ixld and cumlx.‘rsome, no longer die other way amuncl 
So, once we made the decision to rewrite Transmit in 
Cocoa, we decided we would remodel the entire interface as 


well: the goal, as with all Panic produtls, was to make 
'lYansmit feel like a part of Mac OS X itself, as if it came straight 
out of Cupertino. 

Till; IPnTRTACE 

Two things make Transmit unique among iTP clients. First, 
the main interface is alhin-one - it not only contains iLs own 
Imilt-in local file browser, but also an in-line connection panel for 
entering server information, all in one window. Tliis unification 
allows llie user to bieeze thrt>ugh their KI P session. Secondly, 
we rely heavily on htnder-like metaphors and tiehaviors to make 
our application feel more like an extension to the Finder itseU 
rather than a stand-alone FTP app. For example, you drag and 
drop to upload and dow'nload. You click and wait to rename. 
You drag to the trash to delete. You drag inio a folder to move. 
As we like to say, "If you can use a Mac, yt)u can use Iransmit." 

When updating the main interlace for Mac OS X, it was 
imjxjnant that we maintained a careful Ixilance: adopt the best 
new de.sign features that Mac OS X has to offer, but don’t destroy 
the essence of our application's identity - dt3nY break what 
works welL but iin[>rove whal doesn't. It was a very tough task. 
Here's the re.sult: 



Figure /. Mac OS 9 k Tnimmil 1.7 


Caliel Sasser is ihe other co-founder of Panic tnc., and ts Panic's primary riglii hram, responsible for design in all its many forms. He also buys all 
the weird new food products for die guys in the office to try out (Funky Fries, anyone?). Feel free to send Cal>el any e-mail at cabel@panicLConi. 
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^^ithout a doubty Premiere Resource Editor 
for the Mac OS A wealth of time-Having tools” 

- MacUser Magazine Eddy Awards 

‘A distinct improvement over Apple's ResEdiC 
- Macl^ech Magazine 

Every Mac OS developer should own a copy of Rtisorcerer’' 

- Leonard Hosenthof Aladdin Systems 

'Without Resorcerer, our localization efforts would look like a 
Tower of Babel, Don't do product without it!" 

— Greg Galanos, CEO and President Metrowerks 


'Resorcerer's data template system is amazing," 

— Bill Goodman, author of Smaller Installer and. Compact Pro 

Resorcerer Rocks! Buy it, you will NOT regret it." 

- Joe Zobkiw, author of A Fragment of Your Imcigination 

Resorcerer will pay for itself many times over in saved time and effort" 

- MacUser review 

"The template that disassembles PICTs is awesamer 

- Bill Steinberg, author of Pyro! and PBTools 

Resorcerer proved indispensihle in its own creation!" 

- Doug MeKenna, author of Resorcerer 






Version 2.0 


The Resource Editor for the Mac ™ OS Wizard 


ORDERING INFO 


Requires Systetn 7,0 or greater, 
1.5MB RAM, CD-ROM 

Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PO's, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 

MATHEWLESTI-IETICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440^0504 
re sorcerer® mat hemae s thet ic s. com 


• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (‘aete^) Apprentice Editor 

• Mac OS 8 Appearance Manager-sawy Control Editor 

• PowerPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves^ folder attribute editing 

• Ships with PowerPC native, fat, and 68E versions 


• Fully supported; iVs easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource Rles from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bil List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvont, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, 'ietb's, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


Toorderby credit card, or to get the latest news, bug fixes, updates, and apprentices, visit our wcl^ite* 

www.mathemaesthetics.com 
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Figure 2 Mac OS Xs Transmil 2.0 


Consider Toolbars 

The Wvsi ihing we added lo Traasniii 2'f^ inierface w'as a 
tooll^ar. You’ll notice them in virtually eveiy Mac OS X 
application, from Mail all the w-ay down to the humble Print 
Cenier. Despite seeming ^itnmk:ky, w'eVe learned to love 
ttxdbars: it’s far easier to mouse over to a shiny ico[i than to 
navigate tlirough tiieiius when you want to pertbrm an aaion in 


a hurry. Additiorially, some of your best features can get lost 
under heaps of cascading menus — tcx)lbars help new users 
easily discover all your application has to offer. 

Sf), iJ' your application has a lot of '"actions'’ tucked away in 
the menus, there’s no quicker M^ay to make it feel like a good 
Mac OS X citizen than to install a toolbar. Here are some things 
we kept in mind when designing tlie Transmit 2 Loolban 

• Choose your items carefully. Don't make evaything available 
In your toolbar, only the actions you think the user is likely Lo 
access often. If the feature is so obscure that only 5% of your 
users carcj it probably doesn’t need to go into the t(x)ll>ar For 
example, we didn't ad<i “Send Raw FTP Command” to the 
loollrar- iPs so hard core, it’s best left in the menus. 

• Choose your default toolbar .set even more carefully. Don’t 
overwhelm the user with a toolbar longer than the Great 
Wall of China on first iaundi. In Transmit we have 
"Upload” and “Download” buttons that the user can add to 
the roolbar If they desire, but we don’t put them in the 
iot>li>ar by default - we w'am the user to discover the "drag 
and drop” method of uploading and downloading first, 
since it's hr more natural. 

• Don’t add fundamental application actions to your toolbar, 
it [iiay seeEii obvious, l^ut your toolbar should not have a 
“Quit” button. The same gtoes for "Preferences”, "About”, 
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“Help'*, '‘Hicle”, etc. Your applicaiion .should i>e alreaciy 
pri)vitling a coiniiion and consistent place for lliese I y pi cal, 
evcry-app actions. 

* Try to use the toolbar lo siinpiify your interhice. You II norice 
we moved die "Cancer hiinon from our main inicrtace 
window up into the tcnrlhar - nestled among die other 
actions, it reduces the c*iutter in die main interface view, and 
fits well with other actions. 

• Think a bit about your clefault tottlhar's item order. In 
Transniids case, the two desiruciive actions - Quicel and 
Disconnect ” are the black .slieep {)f the loolbar, sliunned 
away on the right and .sefiarated with a ilexitile space tt> 
retiuee die likelihwKl of accidental clicks. You'll also notice 
that a separator sits Ix^iwecn the action icons (New Folder, 
Refresh) and the ItKadon icons (Home. DtKuiiienLs), leiiing 
die user know that these ,sets of icons liehave slightly 
differently. Simple things like spacers and separators can do 
wonders for usability. 




Ceto Pi 


'1: ii 




Fifiure JL Trammit’s defaufj tooUxjn 


Rework the Interface 

With the toolbars set, we started picking and choosing our 
primary' interface elements, carefully considering ilie usefulness 
of eacli and asking ourselves, "Qm we do this better?” 

In the botUun of the original Transmit window was a 
*'Show More Information" disclosure triangle. When clicked, 
the window' woukl resize to reveal multiple informational 
text fields containing data about the active connection. 
Although it was a fun widget to mindlessly click on while a 
transfer is running, there w-as really no reason for "More 
Information" to he tipiional - virfualiy everyone ran Transmit 
with ‘*Show' More Informadon*’ open. After all, who wants to 
choose "I want to know less"? We took the conienis of this 
otitional panel and, although we lost a little information in 
the transition, we managed lo roll all of it into a single easy 
to understand status line in Transmit 2. 
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We kepi lIic inishean in the lower-right hand corner of 
Tninsmii's interface, but it is still a matter of some c’onlenlitm. 
Optimally, since Mac OS X offers an always-available tmshcan in 
the Dock, we wanted to encourage users to drag their items to 
the Dock iaslcud, removing an extra control from ovir window 
in the process. However, we found that old-school Transmit 
users fell very lost and Ix^vvildered without their convenient 
trashcan waiting for them in the comer, and users who had their 
Dock set to auto-hide were even mt>re confused aliout how to 
delete items, since no trashcan was visible to them while using 
Transmit In short, we let the trash can stay... for now. 

Finally, you might have noticed a path pop-up contiol, and 
a parent button, smack dab in die main interlace. “Aren't we 
supposed to 'simplify' these kinds of things by placing such 
items in the toolbar?", you might lx? asking. Well, leclinically, 
you're right. After all, the Finder lias Ixah a l)ack l>uttan and a 
path pop“Up in its tcxilhar, and they work just fine. 

Tile j)roblem here, however, is that Tninsmil has two 
separate file views in one window to consider: local and remote. 
If the “parent" buuon was in tlic toollxir, the user would first have 
to click tile side they wanted to change — say, “your stufr — 
and then, with a side selected, they’d be able to click llie parent 
liutton. By having two sets of tliese Lonm>ls, one on each side, 
the user c^.in imniediaiely affeLi U^e one side they wish to affect 
— we cliininaie a selection step in a frequently u.sed action. 

Avoid Metal 

There’s one veiy important thing Tmnsmit’s interface isn't: 
metal With the introduction of Jaguar, Apple pn>vided a situ pie 
checklxix in Interface Builder that still lo this ckiy gives nte niglit 
tremors and cold sweacs: “Textured Window". Jitis inntxvni 
l(x>king lx>x makes your application all shiny and metal, very much 
like ffunes, iFhoio, and, somewhat ciuesiionai:>ly, Adda*ss lkx)k. 

In the A<|ua Human Interface Guidelines, Apple provides a 
very logical description of when the metal Iwk is actc^puiiile. You 
should read it if you're curious, they've certainly pul st>me gcxxl 
thought into it. Hut I will personally summarize it thusly: “Your 
application should use the textuied appearance never" 

In all seriousness, no Mac user wanes a patchwork-cjuilt of a 
desktop, with some windows ice-lined and tjthers moiien-fojged. 
Unless y{)ur application fits the acceptal)le guidelines lo Ihe letter, 
1 say don’t check the box. 1 know it looks ctKil and has a liigh 
novelty value, but if you ship a word-processor with the metal 
textune, we will come to your house and hurt you. Seriously. 

The Freferences 

Ah, prc-fertmies - gateway for tlie everyday tweaker, long- 
sumding domain of the power-user, and defender of all-lhaKandx.*- 
changed. In migrating an appliatiion fitjm Mac OS 9 to Mac OS X, 
you1l likely spend a grL“aL deal of lime re-creating your preferences, 
since tliey'rc^ very control and layout heavy, llie Mitc OS 9 Human 
Interface Guidelines liad a very strict set of rules for typical window 
layout (lots of group txixes, lefL-ju.stified controls, tabs galore, and 
llie like), and all of U is irrelevant in Mac OS X. 


Wiien it comes to lie-designing your preferences, I say: ,sian 
from scratch! Don't load up your old rtfstxiitres and excitedly start re¬ 
arranging and ne-sizing them. Tasic^ad, ofxm up Text Edit, and write 
(Hit a g(KxJ old-fasiiioned simple list of each of your Preferenc^es. 
Then, walk through the list, and consider each preference c'afcfuUy 
— look for ways to combine prclerenccs, to clarify controls, or weed 
rxit preferences tliat are so ol:^cure that the>^'re piolxibly not worth 
tile clutter. Finally, once your list Is done, fire up InLerface Builder, 
and start building a new Preferences window from scratch, working 
only fix>m your list. Your preferences will tliank you for it! (Although 
iliat'd be a Hole creepy. *.) 

Here's some other advice we look wfien bringing Transmits 
preferences up to ctxle: 



Figure 5- 'Ihe "Tmmfers"prifercmais from Mac OS 
Trammit /,7 
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Figure 6. The “Imns/ers"preferences, all nice arid 
Mac OS X-Hke. Ahhb. 
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• Tfiink centered. Mac OS 9 dialogs and windows were 
traditionally left justified, but in Mac OS X, the world is 
centered - even the drop shadows cast down from top and 
c'enier. Thai doesn't mean each item should be individually 
centered, thougli — instead, group your nelateri conln>ls and 
t'aptions, and I hen center that entire group. See our 
“Downloads:* grou[> for an example. 

• Keep a dose eye on fonts. As of this writing, lAK:ida Gmnde 
reigns supreme, almtxsi alw^ays in 12 point And take heed: 
there should lx: no Geneva, Charcoal or, god forbid, Chicagol 

• Let your window^ l>ieathe. Mac OS X windows and dialogs are 
much more spaced-our than ihcir Mac OS 9 counteqiarts, and 
the result is a niudi more airy, much less 
toUillysupercTam[xicked experience. Now that the minimum 
resolution supported by Mac OS X is 80() x 600, there’s no 
reason to jam all of your preference’s into a MX) x 2(X) window. 

• Get rid (jf group Ixixes. They're oh-so-1997. Pbee a static text 
[leading to the left and lop of a series of c’ontrols if you wisli 
to group them visually. Or, for bigger groups, use a static text 
w'illt a horizontal rule iKJttonvjustified to the right of it, then 
)>lace the controls tand sulvgroup.s) unrleme'Jth, 

• ReiiKwe your tal'is. Mhie Mac OS X pRTea'mxrs should now u,se 
a ttx)lbar-like cornn^l at the u^p of die window, anti the window 
slinuki resize appropriately wdien settions are accessetl. 

• Prune. Like 1 Siiid, we took this re-writing npponunily as a 
chance to re-consitler every preference we had. '1 low many 


peo|>le use thb?* and “Is this really that important?" should 
lue questions you ask frequently. If yt^u remove a conLrol that 
4 people use, sure, you'll probably hear from those 4 people 
(it might lx: die same 4 people we always hear from!), bui 
hundreds of other people might just l>e more likely to find 
what they're kxiking for now tliat the obscure option has 
gone away, I know it’s counter-intuitive to take something 
out of your application, but be brave! And if you need moral 
support, call us. 

Follow these basic rules - and keep the HIG on your 
niglitstand for a while - ant! you'll he well on your way to a 
shiny, Mac OS Xdike preferences experience in no dine. 

Tm Icons 

In the land of Mac OS X, icons are king. Really. Tliere's no 
greater investment you can make for ytiur appliciition than going 
ouL finding a quality icon designer, and making an original set 
of icons. Cobbling together ytmr own icons from oilier 
appiit:ations, snagging icons from the Finder, or re-using 
freeware icon sets is almost always a bad idea - this usually 
lends to siaiatioas such as: “Well, I can't really find an icon for 
'Reset Cache' anyw^here, so FI I use this c(k>I icon of a rubber 
diK'k in a Loti hal wearing a delightful little monocle, since 
jxrople love rubber duck.s! Anti nmnncles! Right? Ikfsides, lielp 
tags were invented fov a reason, right?" 
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In the case of Transniii, we weni Mraighf to llie Iconfactoiy, 
wlio weVe worked witli since 1997 - wcVe always arna7e<l by 
tlieir creativity and quality. TheyVe not alone, though - there are 
many uilentcd Mac OS X^specbiltzing icon artists, some who may 
even work for free (aliliougli, if you work for Microsoft, I 
suspect tliey might charge youj 

Your Ik-'SI bet is to (■irK>gle for something like ^‘Mac OS X 
Icons" OT search tlirough tfie news links ai 'Ihe Iconfactory, 
browse the free icons out tlierc, find an artist wliose style you 
like, and w^rite him or her an e-mail explaining that you need 
their lalents! Make sure the aiiist is equally gtxKl at both the 
tough-to-darify il x i'l toolbar icons ami the very-large and 
[)ht)lorealisiic 128 x 128 application icons. Also, niake sure you 
can dearly explain your exaa icon needs, GtxKJ direction is 
cnicial! And wlien it comes down to piit:e (always tricky), I 
suggest simply asking the author wltat they want in return fm 
tlie work. lc<m people are gofxl people, as long as you Ye a g(KKJ 
person in return. (1 gae,ss that's irue ft^r many things in life.) 

Toolbar Icons 

Wlien working on the Transmit 2 tcx)lbar icons, we kept 
c'oming back to the ini|X)tlance of consistency - the icons 
needed lo resonate with each other, in order lor tlie a}>plic:atton 
to feel culiesive and whole. At the ?vime rime, we wanted the 
irons t<) feel Kintler-like. So, we had to strike a delicate balance 
l>etween our own style and the Finder’s style. The complete 
results are as follows: 
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Figure 7 The many tmihar achK^niurc^ of TmmmU 2^ 

As you can (hopefully) see, e-ach icon shares die same 
language: badges are conslsiently white shapes with a soft 
shadow', non-real-world graphics are rendered in graphite, each 
b<K>kntark-related icon shares the same basic b<x)k, etc. As a 
whole, the Transmit ttxilbar icxjns feel like a ftimily, and help the 
applit'aiion gel. 

DonT lie afraid lo continually revise your icons, eiiiier, 
as your application winds its way through development. Our 
toolbar icons w'ent through many revisions before we fek 
fully comfortable with them. Ids an inexact science - my only 
advice is to trust your intuition and tweak until the icons just 
feel right. If you know for a fact you have no design 
intuition, grab the pickiest Macmsing friend you know and 
run everythitig by tlmm. (As for our many stabs at the 
refresh" icon, pictured below, I’d like lo thank Dave at 
Icon factory for being so patient when 1 wrote him notes like 



Ifs 3am on Sunday morning 


Ifi THE SERVER STILL RUNNING? 


The simple reliability 
solution for Mac OS 9 and X 


End the 
worry with 



4- System-level Crash Detection ■ jg 

patented hardware-software integration ^ 

Automatic Crash Recovery ^ 

system restart er poiver cycler ns needed - ^ 

f Monitor Custom Applications 

software developer's kit and pfug-ins included 

¥ Scheduled Restarts 

cures memory leaks and fra^me/ifHat/on 

♦- Restart after Power Failure I 

even if shut do wn by your UPS ^ 

¥ Comprehensive Error Logging . 

to help you track down pro6/ems 

f Simple Installation 

just plug in AC card and USB cable 


For all these features pius six power 
outlets controllable by phone tones, 
schedules and scripts/consider 
our PowerKey Pro 650 Admin. 


www.sophisticated.coni 

/ SOPl IISTICATED CIRCUITS 


Copyright €):2!0Ci2 Sophisticated Circuits, Inc. Kick-off! and PowerKey are registered tredemarki 
of Sophisticeted Circuits. Inc. M»c OS is a registorad trademarlt of Apple Computer. Inc 






"1 don't know... that one’s a liitlc bit too wispy." Great, 
Cabel. 'i'hanks.) 

O ^ ' ^ O 

figure & veA' tiixf- revisiom of R^esh. 

There was one snag during the creation of our toolbar 
icons that is worth mentioning. Since many features in 
'IVansmit mirror those in the Finder, our instinct was to make 
our looil>ar icons as Apple-like as possil^le. We even 
considered using the exact same icons that the Finder uses 
for things such as "New Folder", However, as we began to 
investigate Apple's icon language, w^e noticed some 
inconsistencies, and evenrually came to the conclusion that it 
would be smarter to invent our own, Appledike style, but 
with a Panic twist. 

Take, for example, icon badges - little icx)ns tliut combine widi 
cxlier icoas to create new icx>as. Plicwi Here are three of Apple's: 


Figure !). Some of Ai}j>le[% differsrti badge slyles 

As you can see, each icon has a different take on badges - 
(me is pseudt>3D, one is centered flat white, one is wliite with 
Li border, etc. With so many .styles present in Apple's work, we 
stnjggled to pick which one was “correct" for our own badges. 
It w'as a ritidie with no answer, as even Apple is siiij aiming and 
perfecting their sryle — there i,s no ""liible" just yet. $o, we 
wound up creating our own New Folder icon, based on Apple’s, 
l)ut filling within our own Traasmit style. It's a l>ii smaller, and 
uses a badge style consistent wiiii all of our other icons. We 
think it',s a gcxxl lialance. 



Figure JO. 'ImmmU's ‘New Folder" (left), ittspired by Apple's, 

Application Icons 

Pve always [telieved that an application icon needs to 
have this unspoken attractiveness to it that just makes you 
want to uncontrollably double dick it even when you don't 
have to. I'm not sure if this is vestigial stimulus from early 
childhood or some kind of terrible commenr on s<K:icly as a 
whole, but I think the more attractive, cute, and polished an 


icon is, the more likely it will gain a permanent place in a 
user's dock, and thus lie a part of their everyday toolkit. 
Admittedly, IVe put some ugly icon.s in my dock in the past, 
but only out of necessity - once a more attractive icon came 
along, Fve almost always dumped the old one and 
immediately upgraded to ilie new, beautiful one. Okay, now 
this is just .sounds weirdly personal. 


Figure IF OurlitHeguy is all groum up! 

(From i-r: Mac aS 7. 5, 8J, 10.0, and 10.2) 

The very first Transmit icon used the standard limited 
color palette for Mac OS 7.5 icons, and was basically a 
“Copland-style” tliree-dimensional taick. The next revision of 
the icon got a whole lot of shading and a little bit of an alpha- 
channel shadow, ilianks to the 32-bii icon capabiUtk.s of Mac 
OS 8. Once Mac OS X came out, the truck grew to 128 x 128 
- but it was one of The iconfaciory's first Mac OS X icons, so 
it was really mt>re of a "st'aled-up" 32 x 32 illustrative truck, 
rather than a plioLorcalistic, Mac OS X-style icon. Finally, the 
Transmit 2 icon underw^ent the ultimate upgrade — a true 
piece of icon ait, even down to Lite headliglits and tire treads, 
that firs perfectly in Mac OS X, 

Wiien designing yt>yr application icon, dtm’i forget to 
spend a few days doing what we call "The Dtx.'k Test", That's 
when you drag your new icon into your dock and,, well., 
leave h there for a wliile! Just live with it. Doe.s it fit in? Does 
it .stand oitt? i low does it look next to everything else? The 
Dock Test is terribly helpful in deciding if your icon is ready 
to go. 

Finally, in case you've ever wondered "why a U^uck?" Well, 
Transmit wa.s originally called Transit! It made a lot more sense 
back ihen, really, Ijcfore liie lawyers got involved. 

„,ANO THK RliSl 

'Ihe HfG, imprcs,sive tome that it is, ain't always give you 
all ilie answers. In our case, there w^rs at least one place where 
we "dew solo", creating a control that isn't really covered in the 
HIG or used anywhere else in Mac OS X. 

The favorites menu in Transmit sits in the corner of t!ie 
connection panel, containing a list of the user’s favorite servers. 
In Transmit 2, it's a pr>p-up menu w'ith no c'aption to the left, and 
the pop-up menu iLself doesn’t display any text ~ just an icon. 
Yc*s, it’s not .sometliing you see often, and thcxsc are certainly two 
violated rules. 
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Figure 12. TmnsmiVs unique yavontes '^ amind. 

But, in our defense, we ihink this custoni control works 
pretty w'ell by combining two glohiil concepts. First, a pop- 
Uf) menu, distinguished with the down-arrow, obviousiy 
contains a list of items that are revealed when clicked. 
Second, a simplified bookmark icon, used throughout our 
application and nearly universal in its readability, indicates 
favorites or Ixjokmarks. We think that anyone looking ai this 
control will know that it’s a menu that contains favorites. Or, 
at ieasi, we hope so, 

(A ilote about the design of the bookmark icon itself: we 
modeled its gray, flat appearance off the “utility buttons” 
Apple has introduced in applications like iPhoto* But, as a 
twist, we shaded the icon with glossy white highlighLs to 
match Mac OS X 10.2’s pop-up menu itself. You won’t find 
this kind of stuff anywhere in the HIG, hut darned if it 
doesn’t feel right!) 

Before you go whipping up some kind of crazy circular 
scrollbar, remember: you should rarely, if ever, find yourself 
rolling your own solution, and if you fmd yourself inventing 
your own controls more often than using Apple’s, yoifre either 
doing something very wrong, or working a new version of Kali’s 
Power Tools. 


Gch)I> Lock 

Here ar Panic weVe always believed that a tnily great 
application is 50% engineering and 50*^0 design - witli any luck, 
you're now ready to tackle that last 50% and bring every comer 
of your application up to spec* With a little interface intuition, 
intense attention to detail, and good old-fashioned Interface 
Buildin', you can make your application sliine as brightly as it 
de.serve.s to under Mac OS X. It's worth the effort, and believe 
me - your crazy users will thank you! 
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HTTP POST Queries from Cocoa Applications 


Integrating web content with desktop 

applications 

Part 3 in a 3-part series 

Introduction 

In the first two nicies in this series, wc saw liow easy ir was 
10 incofponiie hi|»h-quality support for web conieni in CtK'oa 
appiiaiiions, so lon|j as the request for tlie t'onieni could l>e fully 
expressed in the URL. More sophisticated rct|uesCs, einbcxlied in 
I riTP POST requests, are ntH directly available from the Qk'oa 
AFL l.ast month, w'e l)t*i^an expbrifig ht>w to add such a faciliiy 
to Ctx:oa, using the CI'Network pa<’kage of Core Ftnindation to 
build a formatted POST request. 

*l'his month, we will put what we've learned into an 
ObjecTive-C class, that can be initialized with a URL. accept 
query parameters, present the query, and return the result. 

As in the finst two articles, our target weh site will 
Ihomas, the Library of Congress's tkuabase of legislative history, 
at http://thomasJoc.gov/. Well build a little application that takes 
Uie numl'Jer of a CongreStS (for instance the lQ7th Congress that 
sat 2tX)l-02) and the iianie tjf a member of the House of 
Repre,seniatives. and displays a web page listing all the measures 
liiai member sponsored. 

Where we’ve Been 

Last month's article already covered the u,se of Core 
Foundation's CFNeiwork package to assemble and formal a 
POST cjuery. We saw^ how to marshal query parameters in an 
NSMutableDictionary, and how to marry the [Parameters and the 
necessary H'rTP headers into a query packet using a 
CFHTTPMessage. The example ctxle from Iasi month rc-sulied in 
an application that displayed the formatted query, ready for 
dispatch to a server. 


^ Q Q Window 


^ Member: Conyers f_ Build ^ 


Congress: 107 

t- 

POST A5gi* *bm/bdquery HTTP/i .1 ^ 

U ser*Ag e ni : Ge n e ric/1.0 (Mac^Power PC) 

Content-Type: appitcalion/Jt-www-form-uriencoded 
Accept: lexVhtmt p. 

Contenl'Length: 76 

St 

TYPE1 =bimp&Dbdl 07^l07&srch=%2fbss%2fdt07qo 
0 ry .html & Sp o nil d ^SPON &H ME M8=Cg nyors 

tr 

tr 

It 

12 


—pi—iM— u i 

Figure /. Imt monlb BmldP(}Sll)m^r)^ applicatiofh 

CFNerwork also provides a powerful faeility for dispatching 
the queiy once ifs built, and receiving the results, 'Hits mirnth. 
we'll builci an Objectivc-C class, FAWebPOSTOuery^ around what 
we've alrcady learned alx>ut building POST c|ueries. and extend 
it so that gening weh data from a POST can lie as routine as the 
existing GET ciueries hiiilt into Coc'oa. 

SEnTNCr iHE Stage 

Figure 2 show.s the Interface Builder connections for liie 
human-interface .side of our test appliotion. It’.s a Liny variation 
on the applications we've been l>uikling for the last two 
monthS“two fiekls for [>arameters, an NSTextView for reJiulls, an 
MSButton to set the query in motion, and. this time, an 
NSProgressIndicator to demonstniic that our progratn can do 
other things while the tjuery Is in-process. Tlie Fetch button i,s 
wired to our controller object's doQueryi nieihtxi. The controller 
code—die client of our FAWebPOSTQuery class—can be found 
in Listing 1. 


Frilz Anderson has Iseen programming and writing aljoiit the Macintosh since 19B4. He worics (and seek.s work) as a coasuliani in Chicago. You am 
reach him at fritza@rnanoverboard.ofg. 
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Three High-Performance Applications 


Hiinkfree Write 

Thinkfree Write is a powerful word processing application 
that enables you to create rich, professional quality 
documents and Web pages. You can insert tables, 
images, and clipart, or even apply custom layouts to 
your document.*.then effortlessly proofread your work 
with the easy4o-use spelling and auto-correction features* 

Thinkfree Calc 

Thinkfree Calc is a full-feotured, easy-to-use spreadsheet 
application that can easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities* Thinkfree Calc opens, edits, and saves 
directly into the Microsoft Excel (*xls) format, so users 
can seamlessly share documents and collaborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enables you to create high-impact 
presentations including animation effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint (.ppt) format. 

CyberdrivePlus 
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included. CyberdrivePlus provides you with secure, 

Internet file storage and free online software upgrades! 
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F(^ure 2. 7he GFTwimiow moeiijk^ for the t^ST example 


'I’he pfcx'e.ss of making a POST query t"an lx divided into 
three parl.s: framing the query^ ptxsting the formatted query, and 
collecting the results. Taie t() our plan, we find that doQuery: 
consists of only tw<j meilKKl calls— frameQueiv and postQuery 

Framing the query 

The frameQuery method starts by harvesting the query 
parameters, and then creates the FAWebPostQuery object. 
Tilt: object needs a URL for iniiializaiion, because an 
FAWebPostQuery makes no sense without one, and 
optionally an NSDictionary of keys and values for tlie kidy 
of the c|ucry. As we did last month, we marshal the 
parameters of the query in the query object. Parameters that 
never vary can f>e supplied through a constant NSDictionary, 
while paratnciers that could differ with each query are set 
with llte method setPostStringiforKey:. Because POST 
queries are key-value lists, NSDictionary provides a natural 
analogy for specifying the bf>dy of the query. Using 
NSDictionary for initialization, and a method of the form 
set-:forKey: for management, was therelbre an obvious 
choice in API design. 

Sending the Query 

POSTControllers postQuery niethcxi is even sitiqiler: It 
sends die message post to the FAWebPostQuery, Tliat's it. The 
rest of the method sets an NSTimer to call our pendingTimen 
methcKl 20 limes a second so we can run the 
NSProgressIndicator, and deactivates the Fetch (>ultan so we 
don’t have to deal with more than one query at a time. 

Receiving the Result 

Now all the POSTController has to do is let the results 
roll in. FAWebPOSTQuery relies on an informal protocol, that 


its delegate must implement the method 
webPostQuety:completedW1thResult:. When the query has 
finished—successfully or not— FAWebPOSTQuery returns die 
results and any result code to that method. 

fn the mean time, POSTController s timer method, and 
other methods on the Ul thread, have been free to update the 
display and handle user events, bo far as the user, and the code 
that uses FAWebPOSTQuery is concerned, the query takes place 
completely in the background. 


Beirnd the Sc:enes 

Tliads what happens so far as our Ui testbed— 
FAWebPostQuery s client—is concerned. How is it done? 

Last month we went over the issues in using 
CFHTTPMessage to format the POST c[uery. Readers of that 
article should find the and seiPostStringrforKey: 

meiliods familiar^ as well as the initial part of die post 
method, in which the CFHTTPMessage is finished off and 
readied for sending. 

We could have the CFHTTPMessage turn over iLs serializaJ 
bytes, send litem directly, and handle the rest of the transaction 
ourselves, but there Ls a much neater jneclianism available, an 
clalx)ralion of CFStream, the Core Foundation implemeoUtlion 
of the .stream^if-hytes data ty]>e. 

A CFReadStream or CFWriteStream, alone, is a routine 
sort of abstract data type: It allows you to do se{|uential 
buffered reads or writes on files, sockets, or memory using 
calls similar to tlie POblX read{2) and write(2j functions. In 
this case, the CFReadStream we will be using will serve as a 
read descriptor returning tlie bytes of the body of the query 
response, but that is only one of four roles the 
CFReadStream will be playing. 




Figure 3- 7hc roles of the CFReadStream 

The CFReadStream will 
■ Send the query message to the server. 
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* Make t^JltmcLs to FAWebPoslQuery rode when events occur, 

* Be a client of the appitotion's ain lcK>p, to get a share of 
processor time to tio its work. 

* Yield bytes of U ic response to the query in response to a read 

call. 

Eacli of tliese roles hcs U) lx: initialLsed and (evenaiaky) torn down. 

Role 1: Sender of the query 

The process starts with creating a CFReadStream for this 
transaction: 

roplyStream ^ CFReadStreauiCr^ateForHTTPReqiiest( 

kCFAilocatorDefau] I, ; 

CFH€ lease (racSfiagp.) t 

message = NULL; 

Betiiuse the CFReadStream will be responsible for sending 
the POST t[ueryj llic first thing we do is to assrx iaie ilie query 
me.sf>age with the stream. At this point. FAWebPostQuery has no 
further busines.s with rhe c]uery message, so it calls CFRelease 
tc^ release its hold on it. This doesn't deallocate the message— 
the stream stiil retains u reference to it, and will release its 
reference later. Ihe mes.sage will actually be sent when call 
CFReadStreamOpenQ 

Role 2: Sender of event callbacks 

Next, we initialize the streams role as a sender of event 
messages to the FAWebPostQuery. The FAWebPostQuery wilt 
want to know^ when data arrives in response to tlie quety, and 
when the query transaction has finished—successfully or not. 

BOOL queued ” CFReadStrearaSetGlieiit ( replyStream, 
kCF St r eamEv en t Ra s B yt Ava i 1 ab U* | 
kCFSt rcamEvetit Error Occur red | 
kCFSl rcaraRventEndETicountered, 
HyReadCultback. 
liiicf Context] ; 

CFReadStreamSetClient tells our reply stream whai events 
we are interested in; that w^e w'ant our function MyReadCallback 
to called when they happen; and that we want certain 
context information passed to the callback function. 

If you ve done much programming whih APIs that make 
callbacks—for instance, the NSTimer and NSNotifIcation 
mechanisms in Qxtia—youVe lainiliar with the custom of 
providing a 'user info" pointer in the setup of the callback. Ifs 
a way to pass a ptijinrer to an oliject or other helpful context 
iiiftirmation into ycnir calllrack handler. The last parameter of 
CFReadStreamSetClient serves tlie same purpose, but instead of 
a simple generic pointer, this parameter must lx a [X)inier to a 
C FStrea mClientCo ntext si nicLu re. 

The reasoning behind this choice was this: The user info 
that you might want to pa.s.s through to a CFStream callback 
might lie an ordinary pointer; it miglu he a reference-counted 
pointer ro a Core Ftmndaiion object; or it might be a Oxoa 
object, whicli is also reference-counted, but by a different 
mechanism. 'Ihe designers of the API decided that the 


CFStream should have a way ro retain the user-info object if 
that is possible. (If you are done with the object, and the 
CFStream can retain and release it, you can relea.se it 
immediately and not have the headache of guessing when it 
will be safe to release it later.) Hicreiore, you have to wrap 
the user-info pointer in a structure that includes pointers to 
functions that retain, release, and provide a CFString 
de.scriplion of, the user-info data. 

(Other Core Foundation APIs that define context 
stiiictiires allow you to pa.ss NULL for the retain, release, and 
description function pointers if you do mn want to define 
these operations. It is fiiir to assume the same rule :tpplies lo 
CFStreamClientContext. but at the time 1 write this, tliis pan 
of the CFNeiwork API had not yet Ixen fully documented.) 

FAWebPostQuery passes itself as ilie userdnfo object, and 
therefore provides C wrup[xrs to its inherited retain, release, and 
destTtption met I tods. Listing 2 provides the whole story. 

Role 5; Run loop client 

Now^ we are ready lu set the CFReadStream for its third 
n)le, as a client of the application nin loop. 

CFReadStreamSebeduleWIthRunLoop(replyBt ream, 

CFRunLoopGeiCur rent(}, 
kCFRnnLoopCoimiiDtiilodes); 

Veterans of Mac OS 9 and earlier are familiar with the 
even! ioop, the heart of a Macintosh program in the old 
t)peruting system. At the head t>f the event loop is a call to 
WaitNexiEvenlQ, wdiich ret urns whenever user input or some 
other event oeeurs tluil the application must prexos; the rest 
of the loop IS devoted to identifying whai part of the 
application should handle the event, and dispatching control 
to that handler. 

Kvery iliread under Core Foundatiem and Coet>a has an 
event loop of its own. At ba.se, it's a CFRunLoop, which is nut 
toll-free bridged to the Cocoa NSBunLoop—you can gel tlie 
underlying CFRunLoop from an NSRunLoop with the method 
getCFRunLoop. As with its Mac OS 9 cousin, it waits for 
events and dispatches them. Unlike the Mac OS 9 event loop, 
the details of the k>op are hidden; the task of calling handlers 
is done automatically; and rhe gamut of “events** that can be 
handled—timer events, driver events, U1 events—is 
practically unlimited. 

A CFRunLoop w'ails, without consuming CPU time, until an 
event cxcurs tliai one of its registered clients can handle. 
Registered c'lienis t'an include CFRunLoopUmers (or their tcjll- 
free e(|uivalents, NSTimers), whose events reflecl the expiration 
of their timers; or I/O objects like our CFReadStream. whixse 
events include ihe arrival of data, end-of-data, or a fatal error. 
When rhe event cxcurs, tlie CFRunLoop calls ihe dicrU's handler 
to respond to the event. In our ca.se, CFReadStream will, in turn, 
call our aillback hinction MyReadCallback. When the handler is 
done, control rcLunis to the run loop, which reiLiras to its sleep, 
wailing for die next event. 


64 


HTTP POST Queries from Cocoa Areucations 


MaCTech • April 2003 







In ihis ease, we register the reply stream with the current 
am loop. By specifying kCFRuftLoopCommonModes, we ask 
that the stream's events be handled u^lles^s the event lix)p is put 
into a mode that explicitly restricts the handling of events. This 
is the usual way to register a nin kx)p client. 

With the call to CFReadStreamOpenO, the <iuery is 
under way, and the respimse arrives over tile next few 
seconds. Against the pt>ssibiliiy it doesn’t arrive at all, we set 
a timeout timer: 

tiieoutTimer = fNSTiaer 

finherii]tcdTiutorWi ihTim&Interval: sPostTlineout 
self 

seLector: iaelector (taessageTimedOut *) 
userInfo: nil 
repeats: HOl : 

ItineoutTimor retain!: 

And, whenever the Tlioinas server gives evidence that it is 
alive—^by sending us data—we restart the timeout eltKk with: 

ftlmfroutTlmcr fSetFircfJoLe: 

[WSDflrf dal c^WI lhT1iii«*JritervalSlnceNow: 
sPoutTlintiOUt] ]: 


Role 4: Read bytes from the stream 

The remaining business of the FAWebPostQuery object is 
to handle the events that come from ihe reply CFReadStream, 
all of which come to the callback function MyReadCallback. 


As you'd expect of an event handler, this function is buOt 
around a switch sUileinenl keyed on the type of event that 
arrived. Because we passed the FAWebPostQuery object as 
the context when we registered the callback, we get it back 
as a void* in the third parameter of the function. 

When the event is kCFStreamEvetitHasBytesAvallable, the 
read stream finally fulfills the one task for which tl is named: 

lITntB bufferiREAO.SiZE] : 

CPIndex bytesKead = CFReadStreamReadtstream. 
buffer, 

READ_SIZE-1): 

//leave 1 byte for a trailing null, 

if (bytesRead > 0) I 

//Convert what was read to a C-string 
buffer [bytesRead] ” 0; 

//Append it to the reply string 
[object appendContentCString: buffer]: 

I 

just as we wouid with a POSIX readQ calf we pass die 
stream poinier, a buffer address, and the available length of the 
buffer 10 CFReadStreamRead. Tlie number of bytes actually 
read is returned. Then the newly-arrived string can lx? ap[X?nded 
to our results string. 

Cleaning up 

1 decided Lo liandle the other two events, 

kCFStreamEventErrorOccurred and 
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kCFStreamEventEndEncountered in the way* Either way, 
the query is over: All errors in CFReadStr^am handling are 
irreeovcrable. In IxXh cases, there are three tasks to cximplctc: 
Harvest the last information the CFReadStream can yield; tear 
down the CFReadStream, and infonn the client of the 
FAWebPostQuery tJial the query has finished, 

WeVe noticed before diat HTTP messages fall into two 
parts, header and body. The bytes returned to 
CFReadStreamRead wliile die response was read were, in fact, 
{mly tlic Ixxly of the response. ITie header of the response is 
kept as an attribute of the CFReadStream. and it is possible to 
gel the response status code tlius: 

C FHTTPMe s s a jeK e f r o p1y “ 

(CFHTTFMessageRef) CFRead StreainCopyProperty( 
treplyStreaJn, 

kCFSt reamFropertyBTTPReapons^Header}; 

// Piill thf f^iCiLS aide fmm Utc liodm 

if (reply) I 
statuaCode " 

CFHTTPKessageGetRespOTiseStatiisCodet reply): 

CFRelease(reply); 

) 


Now that we’re done witli the reply stream, we can release 
it fr(>m iLs various roles, and dealloaite it, 'Ihe first step is 
CFReadStreamCloseQ, which stops all further actions by the 
reply stream. Next, we tear down its role as a provider of 
call batiks i.ti the FAWebPostQuery object (and release any retains 
it niiglu have done on the query object) by calling 
CFReadStreamSetClientO with a NULL client value. Finally, we 
remove the reply stream IVoin its role as a client to tlie run loop 
with CFReadStreamUnschecluleFromRunLoopO. The reply 
stream can now Ix^ released with CFReleaseO. 

CoNcaisiON 

Those of us wiio met Cocoa for the firsi lime in Mac 0*S X 
were amazed at the rich ltx)lbox Apple laid at the feet of 
developers, Tlic riches are still coming in the form of Core 
Foundation Af^Ls like CFNetwnrk. Core Foundation can l)c 
daunting at Unit, but ifs so welklesigned that every Ccxoa 
programmer should consider adding it to his repertoire. 


Lisling la: POSTCoiUroUer.h 

// 

// I’OM’tomralkT.li 
// tkxoaPOST 
// 

finport <Cocoa/Cqcoa .h> 

#clase FAW&foPostQuery: 


dajis FOSlOMitfulJcr 


@lnteriace POSTCuntroller : NSObJect I 

IBOutlet HSTextField * memberName; 

iBOutlet HSTextRield * congressFleld: 

IBOutlet NSProgresBindicfltQr * progress: 


IflOutlet NSButton * fetchButton: 

IBOutlet HSTextVifiv " resultText: 


FAWebPostQuery 
HSTimer * 


theQuery; 
busyTtaer: 


- (iBAction) dfyQuery: (Id) sender: 

- (void) frameQuery: 

" (void) postQuery: 

- (void) webFostQuury: {FAWebPostQuery *) query 

compIetedWithResult: (Int) code: 

- (void) pendingTimer: (NSTiiner *) aTlmer: 

Send 


listing lb: PostCootroller^m 

// 

// l*USTCoMTOlIcrm 
a QkxxiPOS'J' 

// 

linport "POSTController.h" 
iIttpo r L "FAWebPo stQue ry,h" 


jif :i jnstaniDiciioLiary, sllionusLIRL 

thice iniiialiitcd, these will he a dictiorciry and lIRT. tlut constitute tlic parts of a 
nirmbcm 4 ,nic query Uiat don't vary.llic initialkc class method will fill them in.They 
will ht! used in the frjuucQuery itieihod to miiuilm' new FAWebPostQuery objects. 

static NSDictionary * eConstantDlctionaty “ nil; 
static NSURL ’ sTbotnaflURL - nil: 


class ROSTCumroHcr 


IS Implementation POSTCont roller 


initialise 

"lnUiaItoe''da!S methods are called automatically by the Ohjective-C runtime before 
any of the class's methotis are executed In this method, the slalie NSURL and 
NSDiaioiury that omstituie ihc invariam parts of alTiomas qitcry by mcmtjer name 
auf initialKcd. 

+ (void) Initialixe 

f 

if (! sConslantDletioriary) I 

sCqtirtantDictlonary " [fNSDictionary alloc] 
initWithObjecisAndKeys: 
ff-TYPEl". 

@*SPOK". @*Sponfld". 
nil]: 

sThomasURb ” f[NSURL alloc] 
initWitbStringi 

@"ht t p ://thomas.kK,g<w/cgi4MiVbdjquerj'q; 

J 

) 


dtjQuery 

This Is the action meth<Kl for the windowV''Peteh" hmtcm. Jt initinlt^fjcs a new 
FAWebPt> 5 tQucry from the information entered in llie window's Rdds.and then sends 
the query to the Thomas server. 

- [IBAction) doQuery: (id) sender 
I 

[self fraflieQueryl : // JniUaitzc the query 

[self postQuery]: // Execute t lie query 


stopTiiuer 

A cimvenietice uietlHKi that checks to see if a qutiy-pending timer b active, and if so, 
unschedules it from die ran loop. 

(void) stopTimer 

I 

if tbusyTliner) I 

[busyTiiaer Invalidate] : 
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buSyTtmer fvilj 

J 

1 


qutn.We start an NSTuner to jset fycrindlc opportunities to animate our progress 
itulicutor wlitlc ibe qiiery is in pnjgitss. Finaltyv we (kaetivaie the‘Fetch" huttori. 
because I don't want to support multiple or interrupted queries. 


dealbic 

The standard rclease-of-eesimnccs handler ftir deallocation time. 

(void) dealtoc 

t 

[self stopTiinerJ; 

[theQuery release]: 

1 


framcQnerj' 

Harvest the number of the t'oiigrcss and the name of the Congressman from the 
fiespeettve fields, and initlaliite an FAWcliPdstQm ry to soil. 

(void) fraineQuery 

Int congress " IcongressField intValue): 

HSStrlng * member [memberKame stringValue]; 

theQuery ** [ [FAWebPoatOuery alloc] 

InitWlthServerURL: sThomasURL 

postUata: sConstantDictionaryJ ; 


(void) posiQuery 
I 

[theQuery post]; 

busyTimer = [NSTimer scheduledTimerWithTiroelnEerval: 0,05 
target; self 

selector: #selector(pondingTimer;) 
usorTnfo; nil 
repeats; YES]; 

[letchHutton setEnabied: NO]; 

I 


wehPi istQuery; completetiWit liRcsu It: 
The quciy has completed. If it resulted in an error, Inform the user. Otherwise, harvest 
the HTML in the reply ami display it.Tills is the requiR'd method from the 
FAWehPtistDek'gate informal pmtocol 

- (void) webPoatQuery; (FAWebPostQuery *) query 
completedWithRestilt: (int) code 
I 

[aelf ntoprimer]: 


[theQuery setPostString: 

[NSString stringWithFormat; e"d%d”, congress) 
fotKey; [NSString ntringWlthFormat: f?"l}bd1id^ 

congress]]; 


[theQuery setPoslSiring: 

[NSString atringWithFomat: /bss/d%dquery. html" , 

congress] 


forKey; e^sreh"] : 


[theQuery setPostStr ing; member forKcy ^ e^lTMEWF"]: 
[theQuery aetnolegole: self]; 


postQuery 

IcUs the FAWebPostQucry we'R done with prepanition,and that it shtnild send the 


If [code = 200} ( 

NSString * testilt - [theQuery replyContetitl; 

NSBata • theHTML - I result dataUsingEncodlngi 

HSASCllStringEncoding]; 
NSAttributedString ' styledText - 
f [NSAttributedString alloc] 

initNlthHTHL; theHTML documcnIAt tributes; nil]; 

[[resullText textStarage] 

setAttrlbutedStritig: styledText]; 

1 


[theQuery release]; 
theQuery = nil; 

[fetchBiitton aetEnablnd: YHS] : 




\ computer solution is not as simple as adding the parts. 


We want to distribute your software. We are specialists. 

Macro Enter is a solution integrator company oriented to business, government 
offices and educational institutions. 


Me can provide to yew customers; 

Pre and postsales assistance 
Technical Support* 

' Customized packages 
• Help to design and build the best 
computing solution 

‘Special agreement is required. 


mscro 


We sell die technology, not lust the 
hexes that the technolegy comes in! 

Fulfillment • Technical Support 
Downloadable Packages * Sales 

We have more than 40,000 satisfied 
end users in the USA. And. we have a 
Resellers channel too! 


Need an e-Commerce system? 

Use Macro Enter B2C, a complete e-Commerce solution 
that is ideal for software companies. 

• Serial Number and Registered User conirot 

• Muttipte shipping methods and taxes supported 

• Boxed and Downloadable products handled 

• Easy administrator to link online installen and aistomize 

• Invoice backup, ctistomer Quick Response System 

« Fully compatible with Linux, Unix, Windows 2000 and 
MAC OS X servers 

To order a trial Online Store log on to; 
h1tp://www.iiiacroefiter.coiii/trialh2c/ 



lall us at 1-800-622-7568 • e-mail: partners@macroenter.com • Visit www.macroenter.com 











pcndin^'tinicr 

ITie c^baci for the tinjcr dull the PO^ControlJer nms while awaiting eompkriion of 
the nuery. li is liere solely lo run the bar, as a demonstration dtar the prt^gram 

is free to do oihef work wfuk the query ^ fjcing pioccsscd The FAWebPosiQuery 
object keeps a timer of iLs own for timcfouts on tlie query. 

- (void) pondlngTtniftr: (KSTim^r "J aTiraot 

I 

[progress animate: nil]: 

I 

@ond 


listing 2a; FAWebPosiQiiety,h 

// 

// FAWcbPostQiiery.h 
// Jefferson 
// 

^import <Found ation/Foundation.h> 
entitn I 

FAWobPostrneomplete “ -1* 
FAWebPosiNoiRepMed = -2, 
FAWebPostBeplyriiProgrcns = 
FAWebPostlnvalid « 4 * 

FAWebPostTimedOut = -5 

n 


JAWd>i4»siAlrcadyl4isied 

An c5£ception that is thrown if an attempt is made to dtspalch an FAWcl>PostQucry 
that has atrt'atty si'nr its qm‘ry. 

extern HSStrlng ^ connt FAWobPoETAlreadyPosted: 


ebss I'AWehl^wtQiktry 


^interface FAWebPostQuery : HSObject \ 
CFIPPT’PMcssagpRef message; 

CFReudSl roamPef replySt remit: 

NSMutubleDictionitry * postData; 

Int EtaiusCode; 

CFMutableStringRef cfReplyContent; 

NSTiiaer * tlmeoutTiiaet; 


NSObject * delegate: 

GFSt renmCl I entConteiCT cfContext: 


' fid) initVithServerURL: (NSURL *) server: 

- (idj init¥ithServerURL: (KSURL ’) server 

PostData: (NSMctioiiary *) inlllalData; 
' (void) aetPostString: (RSString *) string 
forKey: (KSString *) key; 


(void) post; 

- (void) cancel: 

' (int) atatusCode: 

* CNSString repiyContent: 

- (NSObject •) delegate: 

* (void) setDelegate; (NSObject *) aEeiegate: 
@cnd 


I’AWchPost Delegate 

llib is an informal protocol that must Ik impIcfncnTcd by any object that b pa^ssed to 
Rm: seLDtlegatc: metl tod i)f an l AWebPo^Quer)-. It detiares the signal on' of the 
callback message dot b sent to tlie delegate dijeci when the query either compknes 
or bUs. 

tinierface NSObject (FAWebPostDelegate) 

- (void} uebPostQuery: (FAWebPostQuery *) query 
coffipletedWithResult: (IntJ code; 

eetid 


Listing 2b: FAWebPostQuery', m 

// 

if FAWcbPostQucry.m 
// Jefferson 
// 

ilflaipori ‘'FAWebPostQuery.h** 

jjlnipori "httpFlattcning^h*' 

^define READ_SI£E 1024 

NSString * const FAWebPostAlreadyPosted 
= AWeb Po s t A1 r e ad y Pos t ad ; 

static CFTimeInterval EPostTimeout 15,0: 

// A template for IflTP strcani'clicni contexts 
static CFStreamCiientContext sContext = [ 
0, nil. 

CFCllerilrltetaln. 

CFClinntRelease. 

CFClj ontDescribeCopy 

h 


0Implemontat ion FAWebPostQuery 


class PAWcbl4>stQucry 


timeuutlmerval 

A class metiKH] that returns the iDtcrva], m stTonds. after which an IOTP connectkin 
is consklered to liave timed out . When a query is pa?jrcd, the reply must begin arriving 
within this time interval, and gaps between l^atchcs of data may not last longer. If the 
timer runs out, the connection Is cluNed and die query kuLs with the etrur status 
FAWebPostTimedOiit. 

+ {CFTlmelnterval) ttmooutInterval 
i return sPoatTlmenut: I 


sctTimeontinterval 

Sets the length, in seconds, for all limcoul intervals heginriing after fhb class method is 
called. 

1 (void) sotTimeoutInterval: (CFTimelntervai) nevlnterval 
I 

^PostTimoout " nnwlntorviil; 

I 


f!FClk.mtfietain 

A glue function brklguig ilu: OtjjecUW’C tAWebPDsiQiier)' ol>jeci to Gmc Fountbtioo. 
A poinier to this fiinaion got^ into the rcuin field of tlwr client context for the HTTP 
CFSiream that services the reply to ilic query. 

void * 

CFGllentRecainfvoid * sclfPrrJ 
I 

FAWebPostQuery ‘ object 

“ {FAWebPostQuery *) selfPtr: 

return [object retain]; 

1 


CFCiient Release 

A glue function bridging the tlhjcttlve C FAWebPostQuery^ object to rx>re Fmmdation. 
A poiriier to ibis function goes uilo the release field of I he elknt context lor the IfITI* 
(Jl^ircam that services the reply to the query. 

void 

CFCllontRelease(vaid ’nelfFtr) 

1 

FAWebPostQuery * object 

= (FAWebPostQuery selfPtrr 

[object release]: 

I 


(TClicntDescribeCopy 

A gjtte fuoaion bridging the Objective^! FAWchPifWitQuefy' object to Core Foundation. 
A pointer to this ftmetioa goes into the copyUescriptiofi field of the client context fur 
the im? O'^ttom that services the jtT>l)^ to the C[UC‘fy. 

CFStringRef 

CFCHentDGBcribeCopy(void * selfPtr) 
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Made with 




REALbasic® 


REAL Software and MacTech present the REALbasic Showcase to 
higliliglit some of the fantastic solutions created by REALbasic users 
worldwide.Tlie showcase illustrates the wide range of applications that 
developers using REALbasic can create. Some benefit any Mac user, and 
others are more specific.AU of tliem are seriously cool! 

REALbasic is the powerful, easy-to-use tool for creating your own 
software for Macintosh, Mac OS X, and Windows. It runs natively on 
Mac OS X as well as earlier versions of the Mac OS. For more 
information, please visit: <www.realbasic.com>. 

The Made with REALbasic program is a cooperative effort between 
REALbasic users and REAL Software, Inc. to promote the products 
created using REALbasic and the people who create them. For more 
information about the Made with REALbasic program, please visit: 
<www.realbasic.com/realbasic/mwrb/Partners/MwRbProgram.html>. 






REALBASiC SHOWCASE 



Extend REALbasic with 
Advanced Plugins 

Spreadsheet Controls: 

We provide a wide range of spreadsheet controls for 
REALbasic, (nciuding multistyled and custom rendering 
spreadsheet controls. 


• More than 32k of rows. 

• Classic, OS X and Win32. 

• Accelerated for maximum 
speed. 

• Images in cells. 




OllOOlO 


Cryptography: 

We provide data encryption, encoding, 
compression and hashing for REALbasic. 

Supported Algorithms: 

• Encryption: 

- e-Cryptlt 

- BiowFish (448 bit) 

-AES(Rijndae!) (256 bit) 

• Encoding: 

- e-CryptIt Flexible 

- Base 64 

- BinHex 

- MacBinary III 

- AppleSingle / Double 

- UUCoding 

• Compression: 

-Zip on Strings and streams (.gz) 

• Hashing and Checksums: 


-CRC32/Adler32 

- MD5 / HMAC_MD5 

- SHA / SHA1 / HMAC_SHA1 


Other Plugins: 

We have many other 
plugins for REALbasic, 
including plugins to do 
advanced MacOS 
Toolbox tasks and more 
custom Controls. 


Font 

Size 


Help 



Speed up developement and make 
more advanced applications 
by using plugins ! Get free demos 
at www.einhugur.com 


Einhugur Software 
saies@ein hugu r.com 
www.einhugur.com 



^ piPop 

Pop-up Hierarchical 

File Navigation and Launcher 


'X 

iTelnetLauncher 

^ ?~y 

Bookmark and Launch your 
Telnet and SSH sessions 

n 7 

\ 

r SimpleKeys 

Set your Function Keys 
to type stuff for you! 

piDog Software 

http://www.pidog.com/ 



MAC MUSIC MANAGEMENT FOR 
SONY® 5 TO 400 DISC CD CHANGERS 


Control up to 12 changers (4,800 music CDs) 
Control Any Brand Stereo Receiver 3 
Play MP3 and other Sound Files 
Plus much, much more!!! 


^ , 


vvvvw.titletrai^CDm info^dttetra^'com 
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REALBAStC SHOWCASE 



DOWNLOAD NOW 

www.ebutterfly.com 


Enjoy your personal collection of photos, digital music, 
video clips and more with one integrated media browser 


• Reacts 20 Popular File Formats 

• iPod Audio Playback 

• Audio CD Playback 

• Slideshow with Adjustable Timer 

• Add Favorites to Custom Playlists 

• Zoom & Scals-to-Fit Options 

• Image Rotator 

• Audio Bass & Treble Controls 

• Audio Equalizer Display 

• Search Engine & Media Filter 

• Displays File Properties 

• Improved File Browser 

• Redesigned Interface 



the cross-platform solution 
for Macintosh and Windows 


• build both Macintosh and Windows screensavers 
with a single click, no matter what system* you are using ! 

• use any QuickTime 6.0 movie format: 

Macromedia Flash 5.0, MPEG, Cinepak, MP3, Midi, AVI, DV Video,» 
or, now with version 3,0, build your own basic Slide Shows I 


Corona 

accounting software 


"Easy to set up, easy to use, 
and excellent support from 
the developer." 

Five stars on VersionTracker com 
Four cows on 7\tcows.com 




simple 

WYSIWYG 

editor 

casli entry 
• invoicing 
• payroll 

supports 
Interactive Flash 
and QuickTime 

• reports 

consistent 
cross-platform 
user interface 


try before you buy 
fully functional 
online downloads 


^ ^ ^ _ Version 1.^ now with: sales tax aocountincj 

{p 04 • y j "keyless entry ' invoices 

* drag 'n drop accounts 

Free 30 -day trial 

http://homepage, mac.coni/idle wild/CoronaUS.hqx 



A best friend for business! 

p o. box 472 * aurora • onagon * 97002 
idlewildi3niac.com 


• include a hidden movie that can be unlocked 
with a registratron code 

* customize and fufly-brand both Installers 
and Screensaver control panels with pictures and text 

Screensavers install without DLLs, extensions, or restarts 

err 



creating screensavers 
for both Windows and Macintosh 
has never been this easy 

hM’p.'/^IScre'pn&cevpr.nph 

e=mc3E : info @ 

” KHKnlsd systiEwrih n of Jimn ilOOZ, NxMidfli 
HKXiUKifi OS fi.e HKfiuaft Wkiflms ySZSQAC:, KT4/KT7I70IT/1IF 

Denaner vmwri 3,0 wt lupport tn Mflranlmh OS TO.? 

*£000 £0O£ tocjVi*4c^»lnc. using RfcAUaim:. 
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I 

FAWebPo^t^uery * * object 

(FAWebPaetQuery ") selfPtn 

return (CFStringRcf) [[objpxt description] retain]: 


j;ctRcsuliCyde 

An intemakis: mcUitKi. caJkd wlicn the reply stre^ has indicated that it has either 
Unshed or experienced i fatal error. Retrkw^ the http header fnim the reply 
if possible, and the http result «Mk from ilie header. Sets the FAWebPostQncFy's ^tus 
code to the result code, 

* (void) getResultCodo 
t 

if [replyStreaai) 1 
// (kt the reply headers 
GFRTTPMeanageRef reply “ 

(CFHTTPWoKsageRef) CFReadStreamCopyPropetty( 
replyStream, 

kCFSt reainP ropertyBTTPResponseHeader): 

// Pull tlic status code from the headers 
if (reply) I 
gtattisCnde “ 

CFHTTPKeasageGetResponseStatusCode(reply )i 
CFReleaseCreply)^ 

I 

1 

1 


closet )«t Messaging 

An intcrnakise method, called wlien the C^I'lleadStrcam that manages the queery reply 
is no longer needed—cither ba-ause the whole reply has hcen rccetvcci or because 
the Rt|v*est has failed This method rears down the stteam^the oiigmal lOST query, 
and Uie timeout timer 

* (void) closeOutMessaging 


if (replyStream) I 
// Oosse the read stream. 

CFReadStreamClose t replyStream )t 

// Deregister the callback cUeni [leamed this from WWIK" session 805) 
CFRGadStreatiiSetClieTit(replyStreatii. 0. NULL* NULL): 

// Take the stream out i>f die run Um>p 
CFR e ad S t r ea hill n s e h ed n 1 aFromRunLo o p ( 
replyStreamt 
CFRunLoopGetCurrent0 * 
kCFKunLoopGoHinio nHod e s 1; 

// Dealiocaic tlic siieatn pointer 
CFRel ease (reply St ream); 

// Throw die spent ptHittef away 
replyStream ” NULL: 

) 

if (timeoutTimer) f 

[timaoutTinter invalidate]: 
rtimeoutTimer release]; 
timeoutTimer “ nil: 

I 

1 

informDciegatcOfQjmplction 

This metlMxl gets called when the query has completed, successfully or not, after the 
network streams have Ijccn torn down. If this object’s client has set a delegate, inform 
the ilckgate of conipJetion tlirough the ntctJiod wcbPostQwtyaa^mpletedWiihResult:. 

(void) InformEelegateOfCompletion 

I 

if (delegate) f 
KSAssert( 

[delegate respondsToSelector: 

@selGCtor(yebPofitQuery:coiEpletedWithResult:)), 

©"A web-POST query delegate must implemeni " 
§”webPostqueryiCompletedWithResult:"): 

[delegatE^ webPontOuery: self 

completedWithResult: statusCode]: 

I 

I 


BMS 


THE LAW OFFICE OF 
BRADLEY M . S N I D E R M A N 



If you're developing software, you need your valuable work protected with 
trademark and copyright registration, as well as 
Non Disclosure Agreements. 

Then, when you are ready to sell it, you can protect yourself further 

with a licensing agreement. 

I am an attorney practicing in Intellectual Property, Business Formations, 
Corporate, Commercial and Contract law. 

Please give me a call or an e-mail. Reasonable fees. 


23679 Calabasas Rd. #558 • Calabasas, CA 913 02 

PHONE 818-222-0365 FAX 818-591-1038 EMAIL brad ©snidermaii.com 
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appcndConicntCSiring: 

An intcrmi method talk'd by MyReadCaltl^tck. Ji apiKtids ihe C string U is passed to 
the CFMuUibkSiring that keeps Uie body of ihe reply lo Uic qut^. Passing Uns 
message sets Uiis t>bjcct s stains to In-pcogress, and itsiarts the limemit timer. 


f 


\ 


(void} appendContnntCStringi (char *} cString 

CFStr!ngAppondCStrlng(cfRcplyContenL, 

eStrlng* 

kCFS t ringEnc odingA S ClI): 
jstatusCode = FAWebPostReplylDProgress; 

// Ikfresh the timeout timer. 

[timeoutTiBter eetFiraData! 

fNSDatC datciWithTlpieTniterva]SlnccNow: 
fiPofitTImnout] ] r 


MyReadCaiUhaek 

'llUs is die registered event eallhack for ilie (iFReadSireum that manages sending the 
query and receiving the reply, If data has arriwd in the reply, the data h taken fnmi the 
stream and accumulated. If the transaction ends because error or success, a final 
result ctKle is set. the CPReadStream is torn tkiwn, and the n-gistcred client, if any is 
informed, 


if tbytesRead >0) I 
// Convert what was read to a C-string 
buffetfbytesRoad] ^ 0: 

// Append ii to the reply string 

lobjcct appcndContcntCString: buffer ]i 

I 

break: 

case kCFStreamEventErrorOccurred: 
ease kCFStreamEventEndEncnunteced: 

(object getResultCode): 

[ oh J er.t c 1 o neOut Me f? s 3 g 1 n g]; 

(object InformDelegateOfCcu&pletiotiJ ; 
break; 
default; 
break; 

1 

1 


message lirntdOui: 

The callback for the intcmal timcoui timer.Ibis method gets called only in the 
CTtcepiionaJ cast of the Etmolt server not respond log within die spetilled lime. It's a 
fnal error, and causes the connection to be torn down :md the delegate Cif any) 
notiTied. 


void 

KyRead Ca 11 ba c k (CFR ea dS t r eainRef s t r eas, 

CFStreamEvenrType type, 
void * ttserData] 

I 

FAVehPontQuery ‘ object * 

(FAWebPosJLCjuety *} userData; 

switch (type) ( 

case kCFStreamEventHasBytesAvailable: 1 
tIIntB buffer [READ_SI2El; 

CFIndeX bytesRead CFReadStreaitKead(stream, 

buffer. KEAD.SIZE IJ; 

// leave I byte for a trailing null. 


- (void) mEssageTimedOut; (NSTimer *) thoTlnor 
[ 

statusCgdc = FAWobPostTimedOut; 
fsclf closeOutHessaging]: 

Uclf infomiDelegateOfCoffipletionl; 


- (id) initWlthServerimL: (MSURL M server 

1 

return [self initWithServerllRL: server postData: nilj ; 

1 


- [id) initWithServerURL: (NSURL *) server 

PostData; (NSDlctionary *) initlalData 


replyStreara ^ NULL: 



Tringo Sroatfbiod I* committed lo providing th« best techno logy it the most offordoble 
price for your broadband wlrtltss tccess deployment Cliecli us out and see wtiy oirr 
AcesssS^QQ'* solutioii Is the best In clast. Give us a cal]...Do{it settle for less anymorel 


trangobroadband 

WIRELESS 


FIXED WIRELESS..,THAT WORKS! 


Who has the host fixed wireless 
solution in the industry? 


Thrau^ffptip^-*-: 


Pyrtom/c 

ffajidurijdtft 




Miti§ 






'mm 


Rffce 


There is no 
comparison! 
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cfRepiyContent ^ CFStringCreateHutable( 

kCFAllocatorDefault* 0); 
atatuflCode = FAWebPostlncotnplote; 
cfContext - sContexti 
cfContext.info = self; 
t. i moo ut Timer = nil; 
if (inltialData) 

PostData “ I [NSHutableMctionary alloc] 

initWithMctlonary; inltlalDataJ; 

else 

PostData ^ ffKSHutnblcDlcrionary alloc] 

inittfitbCapacity: S]; 


if (tPostData) I 
[self release]: 
return nil: 

1 

// Set up the POST message 'And its toilm 

message - GFHTTPMefisageGreateReq\jest( 

kCFAilocatorDefault ^ 
CFSTR(‘'POST"K 
(CFURLRef) server, 
kCFHTTPVersionl^l }; 

it (imessage) I 
Iself release]: 
return nil: 

] 

GFHTTPMcssagsEe tliead e rField Value (message. 

CFSTRt’'User-Agent"), 

CFSTR("Generic/1.0 CMac_PovcrPC)")]; 

CtltTTPHessageSetHeade rFleldValue(message ^ 

CFSTRC" Con tent'Typo'*). 

CFSTR(“appl tcatlon/x www fom uriencodietl")): 

CFHTTPMesfiageSctHoade rPleld Va lue (message» 

CFSTR(*'llost”), (GFStringRel) [server host!): 

CFIfTTPMcs sageSetJleaderFleldValue (message ^ 

CFSrR{**Accept"), CFSTR("text/hTml ")); 

return self: 


I 

I 


(void) aetPoatString: (USSlring *> string 
forKoy: (NSString *) key 


IpostData setObject: string forJCey: key]; 


‘ (void) deallot 

I 

if (message) f 

CFRclease(message): 
message ” NULL; 


LpostData releasel: 

If (cfReplyContent) I 

CFReleaee(cfReplyContent); 
cfReplyContent = HULL: 


if ItiraeoutTiiner} t 

[tlmeoutTlater invalidate]; 

[timeoutTiiter deallocf: 
timeoutTimer = nil: 

I 

1 

(void) post 

t 

if (statusCode I*" FAWebPostIncomplete) 

[NSException raise: FAWebPontAlreadyPosted 

format! ^‘‘Tlila query has already been posted ** 
@"and either answered or refused."]: 

atatusCode ^ FAWebPostNotReplied: 

// StringHxii ihc pustlMa dictiuiiary 

NSString * poatStrlng “ fpostData webFormEncoded]: 
NSData ' postStringData - [poatStrlng 


THE BEST SELLING INTERNET COMPONENT 
SUITE FOR WINDOWS, JAVA, LINUX, 
SOLARIS, AND MORE... 




IP*Works! 

' The Only Truly Comprehensive 
’ Internet Toolkit 

' - More Than 30 Components Cover 

■— 1 = All Major Internet Protocols 

I . poiiows Exact RFC Specifications 

- Market-Tested For Over^.7 Yeare 

- In Use By Almost All Forinjne SOOs 

- Royalty-Free Pricing ; 


IP* Works! for Mac OS X (10.0/10.1/10.2} gives you 
access to a host of new capabilities that will connect 
your applications to the Internet with unprecendent- 
ed easy of use, power, and flexibility! You will be 
able to easily and quickly: 

-program the web: HTTP, WehForm. WebUpload 

- call web services: SOAP, XMLp 

- transfer files: FTP, TFTP 

~ send email: SMTP, FileMailer, HTMLMatler 

- receive email: POP, IMAP 

- read/post news: NNTP 

- encode/decode: MIME. NeiCode 

- access directories: LDAP 

- manage networks: SNMP, WhoLs, Ping, TraceRoute 

- build clients and servers: IPPort, IPDaemon 

- build packe t applications: UDPPort, Multicast 

- remote access: Telnet, Rexec, Rsheli, RCP 


...and a whole lot morel - download your free trial 
today from www.nsoftware.com! 




/A software 

www.nsoFtwarc.conn 
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dataUsingEncodln^ t kCFSt ringEncodingASCIl 
allowLossyConversion: YES]: 

if Put thf post data in tKt body of \ht query 
CFHTTFMessagoSetBody (raefiGage, 

(CFDataRef) postStringData)j 

// Now dial wc know bt}w tong the query bady is, put the tengdi in die header 
CFHTTPMessageSetHeadsrFieldValue(message, 

CFSTK(■'Content'length"). 
(CFStrlngRef) iNSString stringWithFomat: 

[postStxingData length]]); 

// initialize the GlteadStrt^am that will moke the request and nutnage the reply 
replyStream = CFReadStreamCreateForHTTPRequefit( 

kCFAllocatorDefault, massage): 

// I have no further business with message 
CFRnlease(message): 
message = NULL^ 

// Register the CFReadStream’s ollbaek dient 
BOOL enqueued - CFHeadStreramSetClientfreplyStream^ 
kCFStreeuRvontHasBytesAvai1ab11 | 
kCFS C reaiiiEveniEr rorOccur red | 
kCFStreamEventEndEticountcred, 

HyReadCallback. 

&efCoiitesct); 

// Schedule the CFRcadSiream for servke by the current run loop 
CFKeadEti:eamScheduleWithRur(Loop(replyStream. 

CFRunLoopGeiCur tGtit ()» 
kCFRunLoop Commo iiMode s); 

// Fire off the request 

GFEeadSLreamOponlreplyStrearn); 

// Waieh for timcmil 
timeoutTimer - iNSTiraer 

scheduledTlmeryithTimeTnterval: sPostTijaeout 
target; self 

selector: ^selector(raessageTinedOut:) 
user Info: nil 


repeais: NO] ; 

[timeoutTimer retain]: 

I 

(void) cancel 

[ 

NSAssett(replyStream. 

@-The program should prevent cancelling " 
fvhen no query is In progress,"); 

[self closeOutHeasaglngi; 
statusCode ~ FAWebPostlnvalid; 


- (int) statusCode ( return statusCode: I 
' (NSStriug *) replyContertt I 

return (NSStrlng *) cfRoplyContent: 

] 

* (NSObject *) delegate I return delegate: 1 
(void) setDelegate: (NSObject *) aDelegate 
I delegate “ aDelegate; ] 

«end 
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KACt SHOWCASE 



Keep track of every second of your time and bill 
for if with Time Track] Built in instructions make 
it easy fo use. It is a simple way to manage your 
billable time for multiple projects and create a 
web page to show to your clients. Only $24.95 
per single user license per platform. Finally! A 
versatile time tracking solution for Macintosh^ 
Windows, and Palm! 


www*trinfinitysoftware»coin 



By TLA Systems 

The Dock with more than one dimension. 

Create multiple docks of any size, assign hot keys and 
even put the Trash back on the Desktop. A flexible and 
feature-laden tool for power-users. Runs natively on Mac 
OS X and 9 in five languages. 

^mnie /ft# smitth to OS X a lot easier for me...' - Sob Le^itus 

\.DrogJhing wn nghtfaHy ft# raSed on mdtspemoble aid to working with your 
Mac...^^M(KilseFllK 

Download a copy now from www.dragtlting.com. 



Watson 1.6 


Winner of the 2002 Apple Design Award for Most 
Innovative Mac OS X Product! An Aqua experience 
for the most useful Web services: TV & Movie Listings, 
Reference, Translation, Stocks, Flights, Package 
Tracking, and more. With an open architecture for 
third-party tools as well. Download the demo now! 


www.karelia.com/watson 



Eudora Internet Mail Server (EIMS) 
3.1 is the latest version of the most 
popular Internet mail server for the 
Macintosh. If you need to handle 
email for a dozen users, or 
thousands of users, EIMS is a 
relioble and easy to use solution. 


EIMS 3.1 is available for 1JSS400.00, tkr# are no limits on the number of users 
that can be added, and free email support b included. 


For more infomrofion, see 

htfp://wwwieudora,co*nz/ 





Got a great product sold through Kogi? 

Promote your product through the very cost 
effective Kagi Showcase in MocTech Magazine. 
For more information, contact us at 

adsales@mactech,com 


April 2003 • MAtfl'ECiH 
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REVIEWS 


Hy Vicki Brown 


Transferring Files for Over a Decade 


One of my oft-used apps 


Fni? i RANSHiR wnn FTP 

Mac OS X provider many choices for rransterrinjj files, using 
FI? and other protocols. Command line Uk)Ls include curl, letch, 
and flpi CilJl-based applications include Fetch (no relation to the 
command line tool), Inleraixliy, MacS!’!?, and RBrowser. fVe 
tried (and (xcasionally used) most of the aforenientioned tools. 
However, for general use anti drag&iiro[> simplicity, my t(x>l of 
choice has always lx?en Fetch. 

Originally created for internal use by Dan mouth College, 
Fetch has been available as Mac OS shareware lor over a decade. 
Two years ago, FetclVs autlior purchased the rights from 
Dartmouth College, making Fetch an ifidependeni product, still 
shareware. Fetch 4.0 is a Carbon application, providing FfF 
.support under both Mac OS 9 and Mac OS X. 

Fetch 4,0 mclutles all of the expected features of an Fl'P 
client, presented in a straiglttforward interfat'e that mimics the 
Finder's 'list view”. Using Fetch is as simple as pressing a button 
(spccirically, the and "Pul...'’ l>utrons). Kven simpler, just 

grab a Hie and drag it into (or out of) the Fetch window. Files 
c:an even be transferred l)erween -servers by dragging l’>etween 
Fetcli windows; there's no need to ,s4ive a tempiirary copy on 
the local disk. 

Fetch claims the distinction of being tlie first Mac OS VTV 
diem to resume downloads; in version 4.0, that functtanaliiy is 
available even after a crash or quit in mid-tnmsfer. In the "set it 
and forget il" category, F'etch's ”AutoiTi[aic" iniasfer mtxle 
includes sophisticated logit' lo choose the a[)propriate file formal 
or transfer mode Uraw/binary" mode or "text” mode). I've found 
that ''automatic" usually guesses correctly. 

Feich ])rovides many luseful features Ixrytmd simple Get and 
Pm of files. 'I’hese include mirror transfers (synchronizing a 
desktop folder with the serv*er in one command), File 
management capabilities (creation, deletion, and renaming of 
remote files and directories from the Fetch window), "Get Info...” 


and "Set Permissions,-.'' commands for remote files and 
directorie.s, and easily maintainairle lists of shortcuLs to 
commonly used servers. 

One of my favorite features is the way Fetch handles URLs- 
!f you paste an FFP URL Ce.g- ftp://ftp.gnu,org/gnu/Manuals) into 
ilie "New Conneciion" diak>g. Fetch automatically does the right 
thing, stripping olT the "ftp://” prefix and pasting tite host name 
and initial direaory into the appropriate fields of the dialog. 

If you're concerned alx)ul security, or need to use FTP from 
behind a firewall, Fetch offers many options. These include 
proxy servers, keychain, Kerl^eros, One-Time Pas.swords, and the 
aliility to respond lo "challenge" systems. 

Fetch is free for use by students, educators, and tax-exempt 
charitable organi/aiions, A single-user Ueease for ocher users 
cost-s $25; mullipledicense packages arc^ also avatlable. For more 
infonualioo, see the Fetch web site (wwwJetchsoftworksxom). 




flOHdfel 


A must have for oil Powerfiooli owners! 


www,devdepot,com/handle 

Phone; 877-DEPOT-NOW • Oulside US/Canada: 805-494-9797 


Put a handle on your 
PowerBook! Works with 
oil 15"Titamuni PowerBooks, 
mokes it easy lo tote yoor 
PowerBook ocross the office 
or otross town. Flips und» 
your PowerBook to creote an 
ergonomicly correct tilt for 
typing and increase air flow 
for cooling. 


L-lli 

fei 

■E 
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Save 15%! 


Fix Your Worst Color Problems! 

Real World experts Bruce Fraser, Chris Murphy, 
and Fred Bunting show you how! 









Real World Color Management 

By Bruce Fraser, Fred Bunting, and Chris Murphy 

0-201-77340-6. $49,99 

Written by professionals for professionals, this complete 
reference on color reproduction for print, the Web, and 
film explains it all. Starting with an in-depth look at color 
theory, the authors go on to discuss how to get accurate 
color from today's top design programs. Powerful 
techniques and tips cover such mission-critical topics as 
developing a color-management workflow and creating 
profiles. 


Time to Make a Change? 

Three new books help you make the switch from PC to Mac, 
QuarkXPress to InDesign, and film to digital. 



psx 

Users '' - 

A SWltcfiorsj' '".XIS 
Gufd6 



InDesign 

forQiiai'kXPress 

Isers 


0M 


for di^nnil 

If 

3 iiri 

Si'fX 

IF-, ^ 

r IwHw 



Mac OS X for Windows 
Users: A Switchers’ Guide 

By David Coursey 
0-321-16889-5-$19.99 


InDesign for 
QuarkXPress Users 
By David Blatner, 
Christopher Smith, 
and Steve Werner 

0-32MS948-9. $34.99 


The Photoshop Book for 
Dig ita I Photog ra phers 

By Scott Kelby 
0-7357-1236-0. $39.99 


Save 15% plus free shipping* on these titles and more! 

Simply go to www.peachpitxom and enter coupon code EM-43AA-MTMC at checkout, 
shipping limited to ground delivery within the United States. 



Peachpit Press 
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haVe two cftoices:^ 


^lo'flfeet deadlines 


-f^use^rtorce 
2. Cut Corners 


der pressure to manage source code and do more in less time. 


Perforce's Fast Software Configuration Management System Is the must'have tool. 




With riva( 5CIVI systems, the only way to 
quicken the pace is to cut comers - but m the 
long run you pay the ptice with missed 
deadlines, uncertain contents, buggy releases 
and no way back to previous builds. 

With Perforce, the fast way h always the 
right way. install it fast, learn it fast, execute 
operations fast. With other SCM systems, 
developers face an unpleasant choice: 
do it the right way or do it the fast way. 

Perforce's speed and reliability mean fast is nghL 
See how Perforce compares with other 
leading SCM systems at 

http://www. perforce.com/perforce/revi ews. h tm I 


Run at full speed even wHh hundreds of users 
and mi//idns of hies. At the core of Perforce lies 
a relational database with we 11-keyed tables, 
so simple operations can be accomplished in 
near-zero time. Larger operations (like labeling 
a release and branching! are translated into 
keyed data access, giving Perforce Ihe scalability 
that big projects require. 

Work anywhere. Perforce is efficient over high- 
latency networks such as WANs, the Internet and 
even low-speed dial-up connections. Requiring 
only TCP/IR Perforce makes use of a well-tuned 
streaming message protocol for synchronizing 
clieni workspace with server repository contents. 


Develop and maintain muttipte ctnietines. 
Perforce Inter-File Branching'" lets you merge 
new features and apply fixes between codelines. 
Smart metadata keeps track of your evolving 
projects even while they develop in parallcL 

Truly cross platform. Perforce runs on more than 
50 operating systems, including Windows and 
nearly every UNIX variation, from Linux and 
Mac OS' X to AS/400 and more. 

Integrate with leading IDEs and defect trackers: 
Visual Sludio.NET', Visual C-m-% Visual Basic , 
JBuilder , CodeWarrior*, TeamTrack", Bugzilla’“, 
ControlCenter', DevTrack' packages, ar\d more. 


Perforce 

SOFTWARE 

Fast Software Configuration Management www.perforce.com 


Download your free 2-user, non-expiring, full-featured copy now from www.perforce.com 
Free (and friendly) technical support is on hand to answer any and all evaluation questions. 


Ail xrjsdflmarfcs ueio hanin iro aNhartho iradamarics or raaitiored! irodeimarJts of xhair ettipKtivo owrtari. 








ftp N fftOM SANTA yini ABE VOtl SUM UL ATED ftV bcpiity^ NOT SO OESPERATELV seefcici^ 

da(K^ lAHih me at ilia ftaitite S inteHiserat. tHimof? Attractive SWF (vjg sinatt, , ivtixy tiijy to 

CaKlp ClL)t>, TItanksI I waa eny^ Can wants good kMskJnci SWM or HI IM wirt antJ spafk. Me 2:t. opcFi \o 
1 ace v<iu again? Will come dowri to tor iromankr: adwoniiirei^, piK^aitiie piissitJUKios and ravenoiirt for rtow 
look lor you Ffiday nigw wefMl long term. Fssenttals hofiesiv. pas- life citpenfiiwoK «r3St33 
slcNV kn'idnosfr, $a(t$iEatily< lr¥te(]riCy; 

npeti nwid ^OMI SWINGING SANTA^ Lunety aian: 


VEGETAFTfAN BOWLER, Vtou 
boughl me a warm beer and slole 
my heait. Used same kind of bail 
and ^ke of lialied; of refiled 
slwsas would fovo to ctial over 
huFfmus, V5604 

GOHtiEOUa^ WEYTY^ BOHN TO 
LAWN CAflE? My hufiband gcrl laxy lease: Km? Itseater, tlaitce, grtIL 
and hired you to nw our lawn. warm ooiTvarsatian. tl yoiiTe tall, 
older Iniilead yon landscapcKl nr>y Ofonio 35 55. iwmi stixrker, linaibdiaNy 

jvhncirldiig laiita!^es iri ways 1 have never seoure^ enjoys nair merlrig /-' lyf™ 

jCuheurty if^ C^iild hdl prcnoiiooe yoiir ifawiimf). ii iiii ^iid : 
fidt lunch? name but looked very sarisuaL. I had 
blue shoes on.. nStKlG. 


llli$.^piliis 


iriT 

tnegtermr 


IUE: lonely SWEDISH LINGERIE IVIODEC 

and gourmet cook. You: slightly overweight 
and without ambition. Must be Into computers, 
roie-playing games and air hockey; ^r5988, 


ididFtoi TWiNswMo sawtwens. 

nry day, IkdndsoirFie guys in ?:.ii.'?p<^rTdi 9 rbiiU 
I wfujid log Mailcse. Ybu^ iwo 
bid I read liglrtiog over Iasi piec^ of gurifivtiat 
dn yoti $iiy tie four ot us mnNStv/o 
inolurig ooupl^^? Twinlot^ 

|^^^■pNONE-RLAVlNa 001 m-: Cdli ma. ^4fA7 
n^^^HnitWilio recttnlly x 

^^^Keorgle r^(50,M DUGOUT RftECRACKER, m 

were ciaaninQ up a baerthat you 
met in iMADisoN, ^piilctd on VbuT wihlle hshirt and 
Would like to itik (brew a whlskoy bottle at (fid 
^^Haln! rrDS67 umpire Mub( meet you and ntake 

• • •cNtdroh,»6651.: 

WCW. Exoltatigad 

At cage maich^ lt mu purd . UORINhYOU^RE GORGEOUS. 

Kic. Would lovafo g'dliyOdiiiV^i' ,. lUdtiy and brim^nL I don'r do^drvg 
nper ttoid ^ ^ ■! 

ifeAUTlFUL AND SEVENT^EiijP'^SY FRpM DOWN SOUTIi Yow.^ai' 
(let you ar tlio MftlAj VSif rtpCft fcffl Hi wfth ivh dt fimitty'it 1 
aio v^ih jMirnociid ni Tfjif 




L^IT^^lNIS 


Create anything from prototypes to full professional applications. Just drag and drop interface 
elements while REALbasic handles the details. You concentrate on what makes your stuff great — 
your ideas! REALbasic creates native compiled applications for Macintosh, Mac OS X and Windows 
without platform-specific adjustments, it's the powerful, easy-to-use tool for creating your own 
software. Each version of your software looks and works just as it should in each environment. 


Complex problems shouldn't require complex solutions. The answer is REALbasic. 


3 REALbasic4.5 


HEW VERSION 


Come see us at Macwortd in MacTech Central! Download a free demo, www.realbasicxom 



















